From a business specification to a structured static website.
Stitchfy converts a Markdown description of a business into a validated website blueprint and a deployable static website — through a pipeline of specialized agents responsible for UX, SEO, accessibility, and frontend generation.
Open source · Apache 2.0 · Built for developers and agencies
What is Stitchfy?
Stitchfy is an open-source framework for producing informational business websites from structured Markdown input. The Markdown specification acts as a durable source of truth for all business requirements — business name, services, location, operating hours, contact information, brand tone, and desired pages.
Rather than passing a single prompt to a single model, Stitchfy separates concerns across a pipeline of specialized agents. Each agent handles a distinct responsibility: business intake, UX strategy, SEO planning, accessibility requirements, and frontend architecture.
The output is a validated website blueprint and a portable static website — HTML, CSS, and JavaScript — that can be deployed to AWS S3 and CloudFront, Vercel, Netlify, GitHub Pages, or any static hosting platform.
Designed for
The core flow
Business Specification
Markdown file describing the business
Validated Blueprint
Structured, machine-readable design decisions
Static Website
HTML, CSS, and JavaScript — ready to deploy
Website delivery involves more than generating a page
Creating a professional business website repeatedly requires decisions that extend well beyond layout and copy. Each project demands consistent answers to a set of interrelated concerns:
These concerns are often repeated across projects and can become inconsistent when handled through a single unstructured prompt. Stitchfy encodes these decisions into a repeatable, auditable workflow — so each project starts from the same principled foundation rather than from a blank prompt.
A structured generation pipeline
Eight specialized stages transform a business specification into a deployable static website. Each stage has a defined responsibility and passes structured output to the next.
-
01
Markdown Specification
The developer describes the business in a Markdown file: services, operating hours, location, contact information, desired pages, brand tone, color preferences, and any additional requirements.
-
02
Intake Agent
Parses the Markdown specification and converts it into structured business data — a normalized, machine-readable representation of all business requirements that subsequent agents can reference.
-
03
UX Agent
Defines page hierarchy, navigation structure, visual direction, typography strategy, hero content approach, and user journeys — translating structured business data into a UX plan.
-
04
SEO Agent
Produces page titles, meta descriptions, canonical URLs, Open Graph metadata, and structured data guidance — ensuring each page is ready for search indexing before any HTML is written.
-
05
Accessibility Agent
Introduces WCAG-oriented requirements covering semantic structure, keyboard navigation, visible focus behavior, landmark roles, ARIA labels, and reduced-motion guidance — building accessibility into the blueprint rather than treating it as an afterthought.
-
06
Frontend Agent
Defines routes, reusable component patterns, implementation guidance, and a clear statement of supported and unsupported capabilities — establishing what the generated site will and will not include.
-
07
Schema Validation
The assembled blueprint is validated against a schema before code generation begins. This step catches structural issues early and produces a stable, inspectable artifact for human review before any output is written.
-
08
Static Website Generation
Produces portable HTML, CSS, and JavaScript output. The generated site requires no application server and can be deployed to AWS S3 and CloudFront, Vercel, Netlify, GitHub Pages, or any compatible static hosting platform.
Choose the generation approach that fits the project
Stitchfy supports two distinct generation paths. Both use the same validated blueprint as input. The difference is in how the final HTML, CSS, and JavaScript are produced.
Template-Based Generation
- No generation API key required
- Deterministic and repeatable output
- Predictable component system
- Fast local generation
- Greater implementation consistency across projects
- Suitable for controlled, repeatable workflows
npm run build:site
Best for teams that prioritize predictability and consistency across multiple client projects.
Google Stitch Generation
- AI-generated page layouts
- Uses the validated Stitchfy blueprint as the design brief
- Greater visual variation across projects
- Requires a Google Stitch API key
- Includes post-generation SEO and accessibility review
- Appropriate when visual exploration adds value
npm run build:site:stitch
Best for projects where visual differentiation matters and the team can review AI-generated output before publishing.
Note: Google Stitch and Stitchfy are distinct products. Stitchfy is the orchestration and generation framework. Google Stitch is an optional AI generation path that Stitchfy can invoke. The blueprint produced by Stitchfy's agent pipeline serves as the structured design brief for the Stitch generation step.
Why use Stitchfy?
Stitchfy accelerates website delivery while preserving the structure, reviewability, and professional practices that informational business websites require.
Structured requirements
The Markdown business specification remains readable, editable, and reusable. It is a genuine source of truth — not a one-time throwaway prompt.
Separation of concerns
UX, SEO, accessibility, and frontend decisions are handled as distinct responsibilities — not compressed into a single model call with a single output.
Auditable output
The validated blueprint makes every generated decision inspectable and easier to troubleshoot before any code is produced.
Repeatable delivery
Teams can apply the same structured workflow across multiple business websites — maintaining consistency in process without sacrificing flexibility in content.
Portable static websites
Generated sites do not require a permanent application server or Node.js runtime. Deploy to S3, Vercel, Netlify, GitHub Pages, or any compatible static host.
Built-in quality guidance
SEO and accessibility checks are incorporated into the pipeline — not added as a final step or left to the developer to remember after the site is already built.
Built for common service-business use cases
Stitchfy is primarily intended for informational websites that help customers understand services, find operating hours, discover locations, contact the business, follow external booking links, and evaluate the business before making contact.
For healthcare-related examples, the generated site is informational. It should not collect protected medical information unless a separate HIPAA-compliant system is implemented alongside it.
Example industries
What visitors typically need from these sites
From specification to deployable output
Each Stitchfy run produces a set of structured artifacts — not just the website itself, but the intermediate decisions and review reports that make the process auditable.
Validated Website Blueprint
A structured, machine-readable description of all design decisions — inspectable before any code is generated.
- Business data
- Pages and routing
- UX decisions
- SEO requirements
- Accessibility requirements
- Frontend structure and quality expectations
Static Website
Portable HTML, CSS, and JavaScript files ready to deploy to any static hosting platform without a server requirement.
- HTML pages
- CSS stylesheets
- JavaScript files
SEO Report
Review of page titles, meta descriptions, canonical URLs, Open Graph metadata, structured data, and relevant page-level elements.
Accessibility Report
Review of semantic and accessibility requirements that can be detected or validated through the framework's pipeline.
Final Review Report
A summary of generated routes, pipeline results, findings, and recommended next steps for the development team.
Focused by design
Stitchfy generates informational static websites. It is designed to produce a strong website foundation — not to replace the specialized systems that handle transactional workflows.
"Stitchfy focuses on generating a strong informational website foundation while allowing specialized systems to handle transactional workflows."
Generated sites may link to existing third-party booking or scheduling platforms. The scheduling functionality itself lives outside the Stitchfy output.
Not currently in scope
Run Stitchfy locally
Clone the repository, install dependencies, and run the pipeline against one of the included example specifications. The framework handles business intake, blueprint generation, validation, and static site output.
Stitchfy ships with example specifications for different business types. Use one as a starting point, or write your own Markdown specification to describe a real project.
# Clone and install git clone https://github.com/devifyllc/stitchfy.git cd stitchfy npm install # Use the example specification cp examples/beauty-salon.md input/project.md # Run the full pipeline npm run stitchfy # Generate the static website npm run build:site # Run the audit reports npm run audit
Prefer AI-generated layouts?
npm run build:site:stitch
Explore, extend, and contribute
Stitchfy is open source. The full codebase is available on GitHub for review, forking, and experimentation.
You can extend it with additional agents for new industries, adapt it to specialized generation workflows, use it as a reference architecture for structured AI-assisted generation, or improve it through issues and pull requests.
Ways to engage
Fork and adapt
Create a pipeline variant for your team's specific workflow or industry requirements.
Add new agents
Introduce additional specialized agents for localization, brand consistency, content review, or industry-specific compliance guidance.
Use as a reference architecture
Study the structured pipeline pattern for use in other AI-assisted generation tasks where separation of concerns matters.
Contribute improvements
Open issues for bugs, edge cases, or feature ideas. Pull requests are welcome.
Build from a specification, not from an unstructured prompt
Inspect the framework, run an example locally, and contribute ideas or improvements. Stitchfy is a starting point — not a finished product that replaces engineering judgment or human review.