Skip to content
Projects

hacrex/the-vibe-coding-handbook

View on GitHub

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.

How these counts are measured

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.

AI

README.md

Original

🚀 Vibe Coding: Zero to Hero

The Complete Open-Source Handbook for AI-Assisted Software Development

License: MIT Contributions Welcome Status

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?

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 Google 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

  1. Complete Beginner? → Start with 02-how-to-start
  2. Know basics? → Jump to 07-prompt-engineering
  3. Ready to build? → Check 16-open-source-projects
  4. Want local AI? → See 15-offline-vibe-coding

Step 3: Build Your First Project

Follow the project-based learning approach:

  1. Pick a project from the roadmap
  2. Use AI to generate initial code
  3. Understand every line (don't copy-paste blindly!)
  4. Debug issues with AI assistance
  5. 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

  1. Read our Contributing Guide
  2. Check existing Issues before starting
  3. Follow our Markdown Style Guide
  4. Submit a Pull Request with clear description

Join the Community


📚 Resources

Essential Reading

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?

Get Started · View Roadmap · Contribute