hacrex/the-vibe-coding-handbook
hacrex/the-vibe-coding-handbook has 85 GitHub stars and 9 forks. GitHot measured -1 stars in 24 hours. Last checked 2026-11-18 11:32 UTC. Last push 2026-11-09.
Measured star growth
- in 24h
- -1
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Complete Zero-to-Hero Guide for Vibe Coding, AI-Assisted Development, Local LLMs, Frontend, Backend, DevOps, Cloud, Hosting, Debugging, Deployment, and AI-Native Software Engineering.
AIREADME.md
Original🚀 Vibe Coding: Zero to Hero
The Complete Open-Source Handbook for AI-Assisted Software Development
A comprehensive, community-driven knowledge base teaching you how to build production-ready software with AI assistance—from your first "Hello World" to scalable, deployed systems.
📖 Table of Contents
- What is Vibe Coding?
- Who Is This For?
- Learning Roadmap
- Repository Structure
- Recommended Tech Stack
- AI Tooling Ecosystem
- Getting Started
- Community & Contributions
- Resources
🎯 What is Vibe Coding?
Vibe Coding is a modern software development methodology where engineers collaborate with AI systems to design, build, debug, optimize, test, deploy, and scale applications faster—while maintaining code quality and architectural integrity.
The Vibe Coding Workflow
graph LR
A[Describe Intent] --> B[AI Generates Code]
B --> C[Review & Refine]
C --> D[Test & Debug]
D --> E[Deploy & Monitor]
E --> F[Iterate & Scale]
F --> A
What Vibe Coding Is NOT ❌
- ❌ Copy-pasting AI code blindly
- ❌ Replacing engineering fundamentals
- ❌ Skipping architecture & design
- ❌ Avoiding debugging & testing
- ❌ Ignoring security best practices
What You Need to Master ✅
| Skill Area | Why It Matters |
|---|---|
| Software Engineering | Fundamentals never go out of style |
| Prompt Engineering | Communicate intent clearly to AI |
| System Architecture | Design scalable, maintainable systems |
| Debugging | AI makes mistakes; you fix them |
| Infrastructure | Deploy, monitor, and scale in production |
| Product Thinking | Build what users actually need |
| AI Limitations | Know when to trust (and when not to) |
💡 Goal: Build software faster while maintaining quality.
📊 The State of Vibe Coding (2026)
Vibe coding has moved from novelty to mainstream practice. Key data as of November 2026:
| Stat | Source |
|---|---|
| ~42% of committed code is AI-generated or assisted | Sonar 2026 survey (1,149 pro developers) |
| 72% of developers use AI tools daily | Sonar 2026 |
| 72% say pure vibe coding is not part of their workflow | Stack Overflow 2025 |
| ~63% of vibe-coding platform users are not developers | Industry surveys (2026) |
| 1M+ pull requests generated by coding agents merged May–Sep 2025 | GitHub Octoverse 2025 |
| Lovable reached $100M ARR with 10M+ projects | July 2025 |
| 96% of developers do not fully trust AI-generated code | Sonar 2026 |
| 65% of vibe-coded production apps scanned had security issues (58% critical) | Escape.tech (1,400+ apps) |
The real divide: between unverified output and accountable delivery. Solo builders often judge apps by visible features; professional teams review every change, require tests, and limit agent access.
👥 Who Is This For?
| Audience | What You'll Gain |
|---|---|
| Beginners | Start coding with AI guidance, learn fundamentals faster |
| Junior Developers | Accelerate learning, build portfolio projects |
| Senior Engineers | Multiply productivity, explore AI-native workflows |
| Freelancers | Ship projects faster, take on more clients |
| Startup Founders | Build MVPs rapidly, validate ideas quickly |
| Students | Learn modern development practices early |
🗺️ Learning Roadmap
Beginner Path 🟢
journey
title Beginner Journey (2-3 months)
section Foundations
Git & GitHub : 1 week
Linux & Terminal : 1 week
Programming Basics : 2 weeks
section AI Tools
Choose Your AI : 1 week
Learn Prompting : 2 weeks
First Project : 2 weeks
section Deployment
Deploy to Vercel : 1 week
Learn Docker Basics : 1 week
Build & Deploy Portfolio : 2 weeks
Projects to Build:
- ✅ Todo App with authentication
- ✅ Personal Portfolio Website
- ✅ Weather Dashboard API
- ✅ Simple Blog CMS
Intermediate Path 🟡
journey
title Intermediate Journey (3-4 months)
section Advanced Skills
Full-Stack Development : 3 weeks
Database Design : 2 weeks
API Architecture : 2 weeks
section DevOps
CI/CD Pipelines : 2 weeks
Container Orchestration : 3 weeks
Cloud Deployment : 2 weeks
section Specialization
Choose Your Path : 4 weeks
Build Capstone Project : 4 weeks
Projects to Build:
- ✅ SaaS Starter Template
- ✅ AI-Powered Chatbot
- ✅ Real-time Dashboard
- ✅ E-commerce Platform
Advanced Path 🔴
journey
title Advanced Journey (4-6 months)
section System Design
Scalability Patterns : 3 weeks
Distributed Systems : 3 weeks
Performance Optimization : 2 weeks
section AI Engineering
RAG Systems : 3 weeks
AI Agents : 3 weeks
Local LLM Deployment : 2 weeks
section Production
Monitoring & Observability : 2 weeks
Security Hardening : 2 weeks
Build Production System : 6 weeks
Projects to Build:
- ✅ Kubernetes-based Platform
- ✅ Multi-Agent AI System
- ✅ Vector Search Engine
- ✅ Production SaaS Product
📁 Repository Structure
This repository contains 46 comprehensive sections covering every aspect of AI-assisted development:
🏁 Foundations (Sections 00-06)
| Section | Topic | Status |
|---|---|---|
| 00-introduction | Welcome & Overview | 🟡 In Progress |
| 01-what-is-vibe-coding | Philosophy & Mindset | 🟡 In Progress |
| 02-how-to-start | Getting Started Guide | 🟡 In Progress |
| 03-hardware-guide | Setup Requirements | 🟡 In Progress |
| 04-ai-models | Model Comparison | 🟡 In Progress |
| 05-ai-tools | Tool Ecosystem | 🟡 In Progress |
| 06-ides-editors | AI-Native IDEs | 🟡 In Progress |
💻 Core Development (Sections 07-14)
| Section | Topic | Status |
|---|---|---|
| 07-prompt-engineering | Prompt Templates & Techniques | 🟡 In Progress |
| 08-frontend | React, Next.js, TypeScript | 🟡 In Progress |
| 09-backend | APIs, Microservices | 🟡 In Progress |
| 10-databases | SQL, NoSQL, Vector DBs | 🟡 In Progress |
| 11-devops-cloud | Docker, K8s, Cloud | 🟡 In Progress |
| 12-hosting-platforms | Deployment Options | 🟡 In Progress |
| 13-testing-debugging | Quality Assurance | 🟡 In Progress |
| 14-security | Security Best Practices | 🟡 In Progress |
🚀 Advanced Topics (Sections 15-24)
| Section | Topic | Status |
|---|---|---|
| 15-offline-vibe-coding | Local AI & Privacy | 🟡 In Progress |
| 16-open-source-projects | Project Ideas | 🟡 In Progress |
| 17-real-world-workflows | Production Workflows | 🟡 In Progress |
| 18-monetization | Making Money | 🟡 In Progress |
| 19-freelancing | Client Work | 🟡 In Progress |
| 20-system-design | Architecture Patterns | 🟡 In Progress |
| 21-mobile-development | React Native, Flutter | 🟡 In Progress |
| 22-ai-agents | Autonomous Agents | 🟡 In Progress |
| 23-rag-vector-databases | RAG Systems | 🟡 In Progress |
| 24-automation | CI/CD, Scripts | 🟡 In Progress |
📚 Resources (Sections 25-45)
| Section | Topic | Difficulty | Status |
|---|---|---|---|
| 25-cheat-sheets | Quick References | — | 🟡 In Progress |
| 26-awesome-prompts | Prompt Library | — | 🟡 In Progress |
| 27-case-studies | Real-World Analysis | — | 🟡 In Progress |
| 28-failure-patterns | What NOT to Do | — | 🟡 In Progress |
| 29-interview-prep | Interview Questions | — | 🟡 In Progress |
| 30-spec-driven-development | Specs > Prompts | 🟡 Intermediate | 🟡 In Progress |
| 31-ai-cost-engineering | Token Costs & Budgets | 🟡 Intermediate | 🟡 In Progress |
| 32-agent-safety-governance | Agent Safety & Governance | 🟡 Intermediate | 🟡 In Progress |
| 33-enterprise-governance | Enterprise Governance & Reliability | 🟡 Intermediate | 🟡 In Progress |
| 34-community-case-studies | Case Studies & Failure Analyses | 🟡 Intermediate | 🟡 In Progress |
| 35-starter-kits | Starter Kits & Boilerplates | 🟡 Intermediate | 🟡 In Progress |
| 36-kubernetes-deployment | Kubernetes Deployment | 🔴 Advanced | 🟡 In Progress |
| 37-self-assessment | Self-Assessment & Certification | 🟡 Intermediate | 🟡 In Progress |
| 38-interactive-quizzes | Quizzes & Certification Track | 🟡 Intermediate | 🟡 In Progress |
| 39-video-tutorials | Video Tutorials & Walkthroughs | 🟢 Beginner | 🟡 In Progress |
| 40-community-discussion | Community & Contribution Tooling | 🟢 Beginner | 🟡 In Progress |
| 41-ecosystem-integrations | MCP Marketplace & Agent Templates | 🟡 Intermediate | 🟡 In Progress |
| 42-aiops-ai-workloads | AIOps for AI Workloads | 🔴 Advanced | 🟡 In Progress |
| 43-agent-collaboration | Agent-to-Agent Collaboration | 🔴 Advanced | 🟡 In Progress |
| 44-compliance-automation | Advanced Compliance Automation | 🔴 Advanced | 🟡 In Progress |
| 45-multi-modal-vibe-coding | Multi-Modal Vibe Coding | 🟡 Intermediate | 🟡 In Progress |
Legend: ✅ Complete | 🟡 In Progress | 🔴 Planned | 🟢 Beginner | 🟡 Intermediate | 🔴 Advanced
🛠️ Recommended Tech Stack
Based on industry trends and AI compatibility:
Frontend Development
┌─────────────────────────────────────┐
│ FRONTEND STACK │
├─────────────────────────────────────┤
│ Framework │ React / Next.js │
│ Language │ TypeScript │
│ Styling │ TailwindCSS + Shadcn │
│ State │ Zustand / Redux │
│ Testing │ Vitest + Playwright │
└─────────────────────────────────────┘
Backend Development
┌─────────────────────────────────────┐
│ BACKEND STACK │
├─────────────────────────────────────┤
│ Runtime │ Node.js / Bun │
│ Framework │ Express / Fastify │
│ Alternative │ Python (FastAPI) │
│ Alternative │ Go │
│ API Style │ REST / GraphQL │
│ Auth │ JWT / OAuth2 │
└─────────────────────────────────────┘
DevOps & Infrastructure
┌─────────────────────────────────────┐
│ DEVOPS STACK │
├─────────────────────────────────────┤
│ Containers │ Docker │
│ Orchestration│ Kubernetes │
│ IaC │ Terraform │
│ CI/CD │ GitHub Actions │
│ Monitoring │ Prometheus + Grafana │
│ Logging │ ELK Stack │
└─────────────────────────────────────┘
AI & Machine Learning
┌─────────────────────────────────────┐
│ AI STACK │
├─────────────────────────────────────┤
│ Local │ Ollama + LM Studio │
│ Cloud │ Claude / GPT-4 │
│ Open Source │ DeepSeek / Qwen │
│ UI │ Open WebUI │
│ IDE Plugin │ Continue / Cursor │
│ Embeddings │ Sentence Transformers │
└─────────────────────────────────────┘
Databases
| Type | Technology | Use Case |
|---|---|---|
| Relational | PostgreSQL | Primary data storage |
| Cache | Redis | Session management, caching |
| Vector | Pinecone / Qdrant | AI embeddings, RAG |
| Document | MongoDB | Flexible schemas |
| Search | Elasticsearch | Full-text search |
🤖 AI Tooling Ecosystem
AI-Powered IDEs & Coding Agents
The winning 2026 pattern: pair an in-editor assistant (Cursor / Copilot) for autocomplete and quick edits with a terminal agent (Claude Code / Codex) for heavy autonomous work.
| Tool | Type | Best For | Pricing |
|---|---|---|---|
| Cursor | AI-first IDE | Daily feature work, Composer 2.5, parallel agents | Free tier / $20–200/mo |
| Claude Code | Terminal agent | Deep repo work, long-running agentic tasks | $20–200/mo |
| OpenAI Codex | CLI + cloud agent | OpenAI-stack teams, delegated tasks | ChatGPT plans / API |
| Google Antigravity 2.0 | Agent-first platform | Multi-agent orchestration, browser testing | Free / ~$20 / $100 |
| GitHub Copilot | IDE agent | GitHub-native teams, lowest entry price | Free / $10–39/mo |
| Kiro | Spec-driven IDE | Specs → design → tasks before code | $20–40/mo |
| Devin Desktop | IDE + cloud agents | Local + cloud agent delegation (ex-Windsurf) | Free tier / paid |
| Cline | VS Code extension + CLI | Open-source, bring-your-own-key | Free + API usage |
| OpenHands | Open-source agent | Headless/CI automation, self-hosting | Free (MIT) |
AI Chat Assistants (flagship / mid-tier / value)
| Model | Family | Best For | Context | Price (input/output per 1M) |
|---|---|---|---|---|
| Claude Opus 5.5 | Anthropic | Long-running agentic coding, hard multi-file work | 1M | $4 / $20 |
| Claude Sonnet 5.5 | Anthropic | Everyday coding, best value mid-tier | 1M | $2 / $10 |
| Claude Fable 5.1 | Anthropic | Hardest reasoning, long-horizon agentic work | 1M | $10 / $50 |
| GPT-6 Astra | OpenAI | Complex reasoning and coding flagship | ~1M | $10 / $50 |
| GPT-6.1 Sol | OpenAI | Near-Astra performance at lower cost | ~1M | ~$2–4 / $10–20 |
| GPT-6.1 Terra | OpenAI | Best value tier | ~1M | $2 / $10 |
| Gemini 4 Argon | Real-world software engineering flagship | ~1M | ~$2 / $10 | |
| DeepSeek V4 Flash | DeepSeek | Open-weight, fast and cheap | 1M | $0.15 / $0.60 |
| Kimi K3 | Moonshot AI | Top open-weight model | 1M+ | $3 / $15 |
💡 Model routing rule (2026): route by task, not by habit. Complex multi-file/agentic work → flagship (Opus 5.5, Astra, Argon). Everyday coding → mid-tier (Sonnet 5.5, Sol, Flash). High-volume/repetitive steps → cheap/fast tier (Haiku 5.5, Luna, Terra, Flash-Lite).
Local AI Setup
# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh
# Pull current open-weight coding models
ollama pull deepseek-v4-flash
ollama pull glm-5.3
ollama pull kimi-k3
# Run with Open WebUI
docker run -d -p 3000:8080 \
--add-host=host.docker.internal:host-gateway \
-v open-webui:/app/backend/data \
ghcr.io/open-webui/open-webui:main
🎓 Getting Started
Step 1: Set Up Your Environment
# Clone this repository
git clone https://github.com/yourusername/vibe-coding-zero-to-hero.git
cd vibe-coding-zero-to-hero
# Install essential tools
# - Git, Node.js, Docker
# - VS Code or Cursor
# - Ollama for local AI
Step 2: Choose Your Learning Path
- Complete Beginner? → Start with 02-how-to-start
- Know basics? → Jump to 07-prompt-engineering
- Ready to build? → Check 16-open-source-projects
- Want local AI? → See 15-offline-vibe-coding
Step 3: Build Your First Project
Follow the project-based learning approach:
- Pick a project from the roadmap
- Use AI to generate initial code
- Understand every line (don't copy-paste blindly!)
- Debug issues with AI assistance
- Deploy and share your work
🤝 Community & Contributions
This is a community-driven project. We welcome contributions of all kinds!
How to Contribute
- 📝 Write guides - Share your expertise in any section
- 🎨 Create diagrams - Visual explanations help everyone
- 🐛 Report issues - Found errors or gaps? Let us know
- 💡 Suggest topics - What should we cover next?
- 🔧 Improve tooling - Better workflows, scripts, templates
Contribution Guidelines
- Read our Contributing Guide
- Check existing Issues before starting
- Follow our Markdown Style Guide
- Submit a Pull Request with clear description
Join the Community
- 💬 Discussions: GitHub Discussions
- 🐦 Twitter: @YourHandle (coming soon)
- 💻 Discord: (coming soon)
📚 Resources
Essential Reading
- Blueprint.md - Complete vision and structure
- ROADMAP.md - Detailed learning timeline
- RESOURCES.md - Curated external links
- CONTRIBUTING.md - How to contribute
External Resources
| Category | Resource |
|---|---|
| Learn Git | Git Handbook |
| Learn React | React Docs |
| Learn Docker | Docker Docs |
| Prompt Engineering | Prompt Engineering Guide |
| System Design | System Design Primer |
📄 License
This project is licensed under the MIT License.
🙏 Acknowledgments
Built with ❤️ by the community, for the community.
Special thanks to all contributors making AI-assisted development accessible to everyone.
🚀 Ready to start vibe coding?