Current route: 6 stages, 18 milestones, 31 actions. Canonical route and terminology.

English | 简体中文

Turn your idea into a real project with AI, even if you have never written code.

Vibe Guide helps beginners describe an idea, choose an AI coding tool, plan development, build and test a first version, and prepare for delivery and maintenance. Each learning step explains what to do, why it matters, what to check, and how to recover when something goes wrong.

Visit the website · 中文站点

• A complete roadmap: 6 stages, 18 milestones and 31 actions, with expandable explanations and troubleshooting.
• Editable prompt templates: add your project details, confirm the result, and copy it into your AI tool.
• Tools and project choices: compare workflows, project types, technical options, costs, and limitations.
• A resource library: 212 UI component entries with examples, plus development and delivery guidance.
• A plain-language glossary: 755 terms with everyday examples and supporting diagrams.
• What people are building: research into AI use cases and possible revenue, 19 GitHub references, and 50 project directions grouped by scenario.

Project drafts and progress are stored in your browser, with export and restore support. They are not automatically synchronized across devices or between localhost and the public website. Recorded progress is your own confirmation, not an independent assessment of your project.

The research section currently contains Chinese research content with a notice on English routes. Project ideas are hypotheses to validate; revenue is not guaranteed.

Use the Node.js version specified in .nvmrc.

npm ci
npm run dev

Open the address printed in the terminal and visit /en/ or /zh-cn/.

To build and preview the production site, including the full-text search index:

npm run build
npm run preview -- --port 4324

Build output is written to dist/ and is not committed. Full-text search requires the production build; development mode provides navigation shortcuts as a fallback.

npm run check
npm run build
npm run verify

Checks cover generated pages, internal links, templates, learning-state behavior, content coverage, and research preservation. Passing these checks does not prove that every external tool, device workflow, or project idea has been independently tested by a beginner.

The site is hosted on GitHub Pages. Pushes to main trigger .github/workflows/pages.yml, which checks the project, builds it, verifies the /Vibecoding-guide/ deployment paths, and publishes the site over HTTPS.

The local build uses /; the Pages build uses SITE_BASE=/Vibecoding-guide. The workflow prepares public asset paths and generates the Pagefind index for that deployment.

Most project documentation is currently in Chinese.

• Requirements
• Site blueprint
• Content architecture
• Writing standards
• Design system
• Technical architecture
• Implementation plan and task records
• Research implementation and verification
• Flow, milestone and experience repair results
• GitHub Pages deployment record

Use rouice/-prefixed branches and follow requirements → design → implementation → testing → commit → push. Keep credentials, dependencies, generated files, and temporary work out of Git. Historical migration scripts may contain obsolete paths; do not use them to update the current site.

Use npm run quality before building. See contribution instructions, engineering and release procedures, and security reporting.

Original code and accompanying documentation are licensed under MIT. Third-party materials retain their own terms; see third-party notices.