GitHub - johnxie/awesome-code-docs: World-class deep-dive tutorials for open-source AI agents, vibe coding tools, LLM frameworks, and production systems.

   ___                                         ______          __        ____
  / _ |_    _____ ___  ___  __ _  ___          / ____/___  ____/ /__     / __ \____  __________
 / __ | |/|/ / -_|_-< / _ \/  ' \/ -_)        / /   / __ \/ __  / _ \   / / / / __ \/ ___/ ___/
/_/ |_|__,__/\__/___/ \___/_/_/_/\__/        / /___/ /_/ / /_/ /  __/  / /_/ / /_/ / /__(__  )
                                              \____/\____/\__,_/\___/  /_____/\____/\___/____/

Deep-dive tutorials for the world's most popular open-source projects

Learn how complex systems actually work — not just what they do

Browse Tutorials · A-Z Directory · Learning Paths · Contributing · Community

Why This Exists

Most documentation tells you what to do. These tutorials explain how and why complex systems work under the hood — with architecture diagrams, real code walkthroughs, and production-grade patterns.

┌──────────────────────────────────────────────────────────────┐
│                                                              │
│    📖 Typical Docs          vs.     🔬 Awesome Code Docs    │
│    ─────────────                    ─────────────────────    │
│    "Run this command"               "Here's the pipeline     │
│    "Use this API"                    architecture that makes │
│    "Set this config"                 this work, the design   │
│                                      tradeoffs, and how to   │
│                                      extend it yourself"     │
│                                                              │
└──────────────────────────────────────────────────────────────┘

Every tutorial follows a consistent 8-chapter structure:

Chapter	Focus
1. Getting Started	Installation, first run, project structure
2. Architecture	System design, data flow, core abstractions
3-5. Core Systems	Deep dives into the 3 most important subsystems
6. Extensibility	Plugins, custom components, APIs
7. Advanced	Performance, customization, internals
8. Production	Deployment, monitoring, scaling, security

Each chapter includes Mermaid architecture diagrams, annotated code examples from the real codebase, and summary tables for quick reference.

🔎 Find Tutorials by Goal

Use this quick-start map if you searched for a specific outcome.

Search Intent	Start Here	Then Go To
open-source vibe coding tools	Cline	Roo Code → OpenCode → Sweep → Tabby → Stagewise → bolt.diy → VibeSDK → HAPI
spec-driven AI delivery workflows	OpenSpec	Claude Task Master → Codex CLI → OpenCode
build AI agents in production	LangChain	LangGraph → CrewAI → OpenHands → Claude Flow
build RAG systems	LlamaIndex	Haystack → RAGFlow
run LLMs locally or at scale	Ollama	llama.cpp → vLLM → LiteLLM
build AI apps with TypeScript/Next.js	Vercel AI SDK	CopilotKit → LobeChat
build MCP tools and integrations	MCP Python SDK	FastMCP → MCP Servers → MCP Quickstart Resources → Create Python Server → MCP Docs Repo → Create TypeScript Server → Awesome MCP Servers → Composio → Daytona → GenAI Toolbox → awslabs/mcp → MCP Inspector → MCP Registry → MCP Specification → MCP TypeScript SDK → MCP Go SDK → MCP Rust SDK → MCP Java SDK → MCP C# SDK → MCP Swift SDK → MCP Kotlin SDK → MCP Ruby SDK → MCP PHP SDK → MCP Ext Apps → MCPB → use-mcp → MCP Use → MCP Chrome → Firecrawl MCP Server

📈 Trending Vibe-Coding Repos (Verified February 12, 2026)

This section tracks high-impact open-source vibe-coding and coding-agent ecosystems with direct tutorial coverage.

Ecosystem Repo	Tutorial	Stars	Why It Matters
`dyad-sh/dyad`	Dyad Tutorial	19,591	local-first AI app generation workflows
`stackblitz-labs/bolt.diy`	bolt.diy Tutorial	18,997	open-source Bolt-style product builder stack
`cloudflare/vibesdk`	VibeSDK Tutorial	4,762	Cloudflare-native prompt-to-app platform architecture
`vercel/ai`	Vercel AI SDK Tutorial	21,688	production TypeScript AI app and agent SDK patterns
`cline/cline`	Cline Tutorial	57,809	agentic coding with terminal/browser/MCP tools
`RooCodeInc/Roo-Code`	Roo Code Tutorial	22,198	multi-mode coding agents and approval workflows
`continuedev/continue`	Continue Tutorial	31,348	IDE-native AI coding assistant architecture
`anomalyco/opencode`	OpenCode Tutorial	103,218	terminal-native coding agent with strong provider and tool controls
`sweepai/sweep`	Sweep Tutorial	7,636	issue-to-PR coding agent workflows and self-hosted GitHub automation patterns
`TabbyML/tabby`	Tabby Tutorial	32,884	self-hosted coding assistant platform for teams and enterprises
`stagewise-io/stagewise`	Stagewise Tutorial	6,494	browser-context frontend coding agent workflows with plugin and bridge architecture
`Fission-AI/OpenSpec`	OpenSpec Tutorial	23,765	spec-driven workflow layer for predictable AI-assisted delivery
`Nano-Collective/nanocoder`	Nanocoder Tutorial	1,318	local-first coding-agent internals and tool loops
`browser-use/browser-use`	Browser Use Tutorial	78,191	browser-native AI automation and agent execution
`open-webui/open-webui`	Open WebUI Tutorial	123,601	self-hosted AI interface and model operations
`Mintplex-Labs/anything-llm`	AnythingLLM Tutorial	54,477	self-hosted RAG workspaces and agent workflows

📚 Tutorial Catalog

 ╔════════════════════════════════════════════════════════════╗
 ║  🤖  AI & AGENTS  │  🔧  DEV TOOLS  │  🗄️  DATA  │  🎤 SPEECH  ║
 ║   67+ tutorials    │   45 tutorials  │  14 tutorials │  3 tutorials  ║
 ╚════════════════════════════════════════════════════════════╝

Category Hubs

Hub	Focus
AI & ML Platforms	agents, RAG, coding assistants, vibe coding, and LLM operations
Databases & Storage	data systems, search engines, query planning, and knowledge platforms
Systems Programming	runtime internals, infrastructure patterns, and architecture mechanics
Web Frameworks	AI application frameworks, chat stacks, and modern full-stack architecture

🤖 AI Agents & Multi-Agent Systems

Build autonomous AI systems that reason, plan, and collaborate.

Tutorial	Stars	Stack	What You'll Learn
LangChain	100K+	Python	Chains, agents, RAG, prompt engineering
LangGraph	8K+	Python	Stateful multi-actor graphs, cycles, persistence
CrewAI	24K+	Python	Role-based agent teams, task delegation
AG2	40K+	Python	Community successor to AutoGen, multi-agent conversations
AutoGen	40K+	Python	Conversable agents, group chat, tool integration
OpenAI Swarm	18K+	Python	Lightweight agent handoffs, routines
Smolagents	14K+	Python	Hugging Face code agents, tool calling
Phidata	17K+	Python	Autonomous agents with memory and tools
Pydantic AI	5K+	Python	Type-safe agent development
AgentGPT	32K+	Python	Autonomous task planning and execution
SuperAGI	16K+	Python	Production autonomous agent framework
ElizaOS	17K+	TypeScript	Multi-agent AI with character system
OpenClaw	119K+	TypeScript	Personal AI assistant, multi-channel
Deer Flow	-	Python	Research agent workflows
Letta	14K+	Python	Stateful agents with long-term memory
Anthropic Skills	59K+	Python/TypeScript	Reusable AI agent capabilities, MCP integration
Claude Flow	14.0K+	TypeScript	Multi-agent orchestration, MCP server operations, and V2-V3 migration tradeoffs

🧠 LLM Frameworks & RAG

Retrieval-augmented generation, model serving, and LLM tooling.

Tutorial	Stars	Stack	What You'll Learn
LlamaIndex	38K+	Python	Data connectors, indexing, query engines
Haystack	18K+	Python	Pipeline-based search and RAG
DSPy	20K+	Python	Declarative LLM programming, optimizers
Instructor	10K+	Python	Structured output extraction with Pydantic
Outlines	10K+	Python	Constrained LLM generation
Chroma	16K+	Python	AI-native embedding database
LanceDB	5K+	Python/Rust	Serverless vector database
RAGFlow	30K+	Python	Document-aware RAG engine
Quivr	37K+	Python	Second brain with RAG
Mem0	24K+	Python	Intelligent memory layer for AI
HuggingFace	145K+	Python	Transformers, model hub, training and inference
Semantic Kernel	23K+	C#/Python	Microsoft's AI orchestration SDK
Fabric	26K+	Go/Python	AI prompt pattern framework

🖥️ LLM Infrastructure & Serving

Run, serve, and manage LLMs in production.

Tutorial	Stars	Stack	What You'll Learn
Ollama	110K+	Go	Local LLM serving, model management
llama.cpp	73K+	C++	High-performance local inference
vLLM	38K+	Python	PagedAttention, continuous batching
LiteLLM	15K+	Python	Unified API gateway for 100+ LLMs
LocalAI	27K+	Go	Self-hosted multi-modal AI
Open WebUI	60K+	Python/Svelte	Self-hosted ChatGPT alternative
LLaMA-Factory	40K+	Python	Unified LLM fine-tuning framework
BentoML	7K+	Python	ML model serving and deployment
Langfuse	8K+	TypeScript	LLM observability and tracing

💬 Chat & AI Applications

Full-stack AI chat platforms and copilots.

Tutorial	Stars	Stack	What You'll Learn
LobeChat	71K+	Next.js	Modern AI chat, plugins, theming
Dify	60K+	Python/React	Visual LLM app builder
Flowise	35K+	Node.js/React	Visual LLM workflow orchestration
CopilotKit	15K+	React/TypeScript	In-app AI copilots
Chatbox	24K+	JavaScript/React	Multi-provider chat client
Vercel AI SDK	21K+	TypeScript	AI-powered React/Next.js apps
Perplexica	19K+	TypeScript	AI-powered search engine
SillyTavern	9K+	Node.js	Advanced roleplay chat platform
Khoj	18K+	Python/Django	Self-hosted AI personal assistant
Botpress	13K+	Node.js	Enterprise chatbot platform
AnythingLLM	30K+	Node.js	All-in-one AI desktop app
GPT-OSS	-	TypeScript	Open-source GPT implementation
Claude Quickstarts	13.7K+	Python/TypeScript	Production Claude integration patterns

🔧 Developer Tools & Productivity

AI coding assistants, build systems, and dev infrastructure.

Tutorial	Stars	Stack	What You'll Learn
Continue	22K+	TypeScript	Open-source AI coding assistant
Cline	58K+	TypeScript/VS Code	Agentic coding with terminal, browser, MCP tools
Roo Code	22K+	TypeScript/VS Code	Multi-mode coding agents with checkpoints and MCP
OpenCode	103.2K+	Go/TypeScript	Terminal-native coding agent architecture, provider routing, and tool safety controls
Sweep	7.6K+	Python/GitHub	Issue-to-PR coding agent workflow with config-driven governance and CI feedback loops
Tabby	32.9K+	Rust/TypeScript	Self-hosted code completion and answer platform with editor-agent integrations
Stagewise	6.5K+	TypeScript/CLI	Frontend coding agent proxy with browser context selection, bridge mode, and plugin runtime
OpenSpec	23.8K+	TypeScript/CLI	Spec-driven artifact workflow for planning, implementation, validation, and archive governance
bolt.diy	19K+	TypeScript/Remix	Open-source Bolt-style AI app builder
Cloudflare VibeSDK	4.7K+	TypeScript/Cloudflare	Build and operate a cloud-native vibe-coding platform
HAPI	1.4K+	TypeScript/CLI	Remote control and approval workflows for local coding agents
Daytona	55.3K+	Go/TypeScript/Python	Secure sandbox infrastructure for AI-generated code and coding-agent execution
OpenHands	67K+	Python	AI software engineering agent
Aider	25K+	Python	AI pair programming in terminal
Claude Code	-	TypeScript	Anthropic's AI coding CLI
Anthropic API	-	Python/TypeScript	Claude API integration, tool use, streaming
Claude Task Master	-	TypeScript	AI-powered task management
CopilotKit	15K+	React	In-app AI assistants
Nanocoder	-	TypeScript	AI coding agent internals
Codex Analysis	-	TypeScript	Static analysis platform and LSP architecture
Turborepo	27K+	Rust	High-performance monorepo builds
n8n AI	52K+	Node.js	Visual AI workflow automation
Activepieces	20.8K+	TypeScript	Open-source automation platform, custom pieces, and admin governance
Taskade	-	AI/Productivity	AI-powered project management
Browser Use	10K+	Python	AI-powered browser automation
ComfyUI	65K+	Python	Node-based AI art workflows
MCP Python SDK	21.4K+	Python	Building MCP servers and tool integrations
FastMCP	22.8K+	Python	MCP server/client framework, transports, and integration workflows
MCP Servers	77.6K+	Multi-lang	Reference MCP server implementations
MCP Quickstart Resources	984+	Multi-lang	Official cross-language weather server and client quickstart corpus with smoke tests and protocol helpers
Create Python Server	476+	Python/uv	Archived official scaffold tool for bootstrapping MCP Python servers with template-driven resources/prompts/tools
MCP Docs Repo	424+	Docs/MDX	Archived official MCP documentation repository with migration guidance to canonical docs in `modelcontextprotocol/modelcontextprotocol`
Create TypeScript Server	172+	TypeScript/CLI	Archived official TypeScript scaffold tool for generating MCP server projects with resources/tools/prompts templates
Awesome MCP Servers	80.7K+	Curated List	MCP server discovery, evaluation, and operations
Composio	26.5K+	Python/TypeScript	Agent toolkit integration, auth, providers, and MCP patterns
GenAI Toolbox	12.9K+	Go/Node/Python	MCP-first database tools, `tools.yaml` control plane, and connector operations
awslabs/mcp	8.1K+	Python	Official AWS MCP server ecosystem, role composition, and governance controls
MCP Inspector	8.6K+	TypeScript/Node	MCP server debugging across UI and CLI with auth/session and transport controls
MCP Registry	6.4K+	Go	Registry publication, discovery API consumption, and governance operations
MCP Specification	7.1K+	Spec/MDX	Protocol lifecycle, transports, authorization, security model, and governance workflows from the canonical MCP spec
MCP TypeScript SDK	11.6K+	TypeScript	Client/server split packages, transport strategy, and v1-to-v2 migration planning
MCP Go SDK	3.8K+	Go	Official Go client/server SDK patterns, auth middleware, transport operations, and conformance workflows
MCP Rust SDK	3.0K+	Rust	Official rmcp SDK architecture, macro-driven tooling, OAuth support, and async task-oriented runtime patterns
MCP Java SDK	3.2K+	Java	Official Java SDK module architecture, reactive transport layers, Spring integrations, and conformance loops
MCP C# SDK	3.9K+	C#/.NET	Official .NET SDK package layering, ASP.NET Core transport patterns, filters, and task workflows
MCP Swift SDK	1.2K+	Swift	Official Swift MCP client/server setup, sampling controls, batching, and lifecycle-focused runtime operation patterns
MCP Kotlin SDK	1.3K+	Kotlin/KMP	Official Kotlin multiplatform MCP SDK with typed core/client/server modules, capability checks, and transport integrations
MCP Ruby SDK	700+	Ruby	Official Ruby MCP server/client SDK with streamable HTTP sessions, schema-aware primitives, notifications, and release workflows
MCP PHP SDK	1.3K+	PHP	Official PHP MCP SDK with attribute discovery, server builder composition, schema controls, and stdio/HTTP transport patterns
MCP Ext Apps	1.4K+	TypeScript/Spec	Official MCP Apps extension SDK/spec for interactive UI resources, host bridges, security constraints, and migration workflows
MCPB	1.7K+	TypeScript/CLI	Official MCP bundle packaging format and CLI workflows for manifest authoring, packing, signing, and verification
use-mcp	1.0K+	TypeScript/React	Archived official React hook for MCP auth, connection lifecycle, and tool/resource/prompt client integration patterns
MCP Use	9.1K+	Python/TypeScript	Full-stack MCP agents, clients, servers, and inspector workflows across both runtimes
MCP Chrome	10.4K+	TypeScript/Chrome Extension	Real-browser MCP automation with native messaging, network tooling, and semantic tab search
Firecrawl MCP Server	5.5K+	TypeScript/Node	Official MCP web scraping/search server with retries, versioned endpoints, and multi-client integration paths
OpenAI Python SDK	29.8K+	Python	GPT API, embeddings, assistants, batch processing
tiktoken	17.1K+	Python/Rust	Token counting, encoding, cost optimization

🗄️ Databases, Knowledge & Analytics

Data platforms, knowledge management, and observability.

Tutorial	Stars	Stack	What You'll Learn
Supabase	75K+	PostgreSQL/TypeScript	Realtime DB, auth, edge functions
PostHog	23K+	Python/TypeScript	Product analytics, feature flags
NocoDB	50K+	Node.js/Vue	Open-source Airtable alternative
Teable	15K+	TypeScript/PostgreSQL	Multi-dimensional data platform
SiYuan	25K+	Go/TypeScript	Privacy-first knowledge management
Logseq	34K+	ClojureScript	Local-first knowledge graph
OpenBB	35K+	Python	Open-source financial terminal
Athens Research	-	ClojureScript	Graph-based knowledge system
Obsidian Outliner	-	TypeScript	Obsidian plugin architecture
ClickHouse	39K+	C++	Column-oriented analytics DB
PostgreSQL Planner	-	C	Query planning internals
MeiliSearch	48K+	Rust	Lightning-fast search engine
PhotoPrism	36K+	Go	AI-powered photo management
Liveblocks	4K+	TypeScript	Real-time collaboration infra

⚙️ Systems & Infrastructure

Low-level systems, cloud native, and infrastructure patterns.

Tutorial	Stars	Stack	What You'll Learn
Kubernetes Operators	-	Go	Production-grade K8s operator patterns
React Fiber	-	JavaScript	React reconciler internals
Dyad	19K+	TypeScript	Local AI app development
LangChain Architecture	-	Python	LangChain deep architecture guide
n8n MCP	-	TypeScript	Model Context Protocol with n8n
Firecrawl	22K+	Python	LLM-ready web data extraction

🎤 Speech & Multimodal AI

Voice recognition, audio processing, and multimodal AI applications.

Tutorial	Stars	Stack	What You'll Learn
OpenAI Whisper	93.9K+	Python	Speech-to-text, translation, multilingual ASR
Whisper.cpp	37K+	C++	Speech recognition on edge devices
OpenAI Realtime Agents	6.7K+	TypeScript	Voice-first AI agents with WebRTC

🗺️ Learning Paths

 ┌─────────────────────────────────────────────────────────────┐
 │                    CHOOSE YOUR PATH                         │
 │                                                             │
 │  🟢 Beginner    Start here if you're new to AI/ML          │
 │  🟡 Builder     Ready to build production applications      │
 │  🔴 Architect   Designing systems at scale                  │
 └─────────────────────────────────────────────────────────────┘

🟢 Path 1: AI Fundamentals

"I want to understand how AI applications work"

Ollama ──→ LangChain ──→ Chroma ──→ Open WebUI
 (run       (build        (store      (deploy a
  LLMs       chains)       vectors)    full app)
  locally)

🟡 Path 2: Agent Builder

"I want to build autonomous AI agents"

LangChain ──→ LangGraph ──→ CrewAI ──→ AutoGen/AG2 ──→ Langfuse
 (basics)      (stateful     (teams)    (multi-agent    (monitor
                graphs)                  orchestration)  in prod)

🟡 Path 3: RAG Engineer

"I want to build retrieval-augmented generation systems"

LlamaIndex ──→ Haystack ──→ DSPy ──→ RAGFlow ──→ vLLM
 (indexing &    (pipeline    (optimize  (document   (serve at
  retrieval)     search)      prompts)   processing)  scale)

🟡 Path 4: Full-Stack AI

"I want to build AI-powered web applications"

Vercel AI ──→ CopilotKit ──→ LobeChat ──→ Supabase ──→ n8n
 (AI SDK       (in-app        (full chat   (database    (workflow
  basics)       copilots)       platform)    + auth)      automation)

🔴 Path 5: LLM Infrastructure

"I want to run and scale LLMs in production"

llama.cpp ──→ vLLM ──→ LiteLLM ──→ BentoML ──→ K8s Operators
 (local         (GPU     (unified    (model      (orchestrate
  inference)     serving)  gateway)    packaging)   at scale)

🔴 Path 6: AI Coding Tools

"I want to understand how AI coding assistants work"

Continue ──→ Sweep ──→ OpenHands ──→ OpenCode ──→ Tabby ──→ Stagewise ──→ OpenSpec
 (code         (issue      (AI SWE      (terminal        (self-hosted     (frontend       (spec-driven
  completion)   to PR)      agent)       coding agent)    assistant)       browser agent)  delivery)

🟡 Path 7: MCP Mastery

"I want to build AI tool servers and extend Claude with custom capabilities"

MCP Python SDK ──→ FastMCP ──→ MCP Servers ──→ MCP Quickstart Resources ──→ Create Python Server ──→ MCP Docs Repo ──→ Create TypeScript Server ──→ Awesome MCP Servers ──→ Composio ──→ Daytona ──→ GenAI Toolbox ──→ awslabs/mcp ──→ MCP Inspector ──→ MCP Registry ──→ MCP Specification ──→ MCP TypeScript SDK ──→ MCP Go SDK ──→ MCP Rust SDK ──→ MCP Java SDK ──→ MCP C# SDK ──→ MCP Swift SDK ──→ MCP Kotlin SDK ──→ MCP Ruby SDK ──→ MCP PHP SDK ──→ MCP Ext Apps ──→ MCPB ──→ use-mcp ──→ MCP Use ──→ MCP Chrome ──→ Firecrawl MCP Server
 (build             (build servers      (reference        (multi-lang             (python scaffold        (archived docs        (typescript scaffold      (discovery and          (tool + auth   (sandbox        (db-focused           (aws server          (debug +            (publish +           (protocol             (client/server         (go sdk +            (rust rmcp +         (java sdk +          (csharp sdk +         (swift sdk +          (kmp core +            (ruby server +          (php server +          (interactive ui +      (bundle pack +         (react hook +         (full-stack          (chrome native +      (web scrape +
  servers)           fast)               implementations)  quickstart set)         bootstrap path)         migration map)        bootstrap path)          curation)               runtime)       infra)          mcp control plane)    ecosystem)           transport tests)     discovery ops)        contract deep dive)    sdk internals)         conformance)          task/oauth focus)      spring modules)        aspnet filters)        lifecycle controls)    transport model)        client workflow)        discovery model)        host bridge model)      sign verify)            archived guidance)      mcp workflows)        semantic tabs)        search/crawl)

Duration: 100-135 hours | Difficulty: Intermediate to Advanced

🟢 Path 8: Speech & Voice AI

"I want to build voice-first AI applications"

OpenAI Whisper ──→ Whisper.cpp ──→ OpenAI Realtime Agents ──→ Voice Apps
 (Python ASR,       (edge            (voice-first             (production
  fine-tuning)       deployment)       conversations)           voice apps)

Duration: 25-35 hours | Difficulty: Intermediate

🟡 Path 9: OpenAI Ecosystem

"I want to master OpenAI's tools and APIs"

OpenAI Python SDK ──→ tiktoken ──→ OpenAI Whisper ──→ Realtime Agents
 (core API,          (token         (speech              (voice
  embeddings,         optimization)  recognition)         agents)
  assistants)

Duration: 35-45 hours | Difficulty: Beginner to Intermediate

🔴 Path 10: Vibe Coding Platforms

"I want to build and operate vibe-coding stacks end to end"

Dyad ──→ bolt.diy ──→ Stagewise ──→ Cline ──→ Roo Code ──→ VibeSDK ──→ HAPI
 (local      (OSS app      (frontend      (IDE        (multi-mode    (cloud         (remote
  builder)    builder)      browser agent) agent)      dev team)      platform)      approvals)

Duration: 35-50 hours | Difficulty: Intermediate to Advanced

📊 Collection Stats

╔══════════════════════════════════════════════════════════╗
║                  COLLECTION OVERVIEW                     ║
╠══════════════════════════════════════════════════════════╣
║  📦 Total Tutorials        185                           ║
║  📝 Numbered Chapters      1,483                         ║
║  📏 Tutorial Markdown      477,000+ lines                ║
║  ⏱️  Estimated Hours        1,980+                        ║
║  ✅ Local Broken Links      0                             ║
║  🧭 Structure Drift         0 (all root canonical)        ║
╚══════════════════════════════════════════════════════════╝

Stats are synchronized against:

tutorials/tutorial-manifest.json
scripts/docs_health.py baseline checks

🛠️ How Tutorials Are Built

Each tutorial is generated using AI-powered codebase analysis, then reviewed and enhanced for accuracy. The process:

┌──────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────┐
│  Crawl   │───→│   Identify   │───→│   Generate   │───→│  Review  │
│  Repo    │    │  Abstractions│    │   Chapters   │    │ & Polish │
└──────────┘    └──────────────┘    └──────────────┘    └──────────┘
   Clone &         Find core          Write 8-ch          Verify code
   index files     classes &          tutorials w/         examples &
                   patterns           diagrams             architecture

Inspired by Tutorial-Codebase-Knowledge by The Pocket.

Built & Maintained With

Tool	Purpose
Taskade	Project planning, AI-powered content generation
Claude Code	Codebase analysis and tutorial writing
GitHub Pages	Tutorial hosting with Jekyll

🤝 Contributing

We welcome contributions! Here's how you can help:

┌─────────────────────────────────────────────────┐
│              WAYS TO CONTRIBUTE                  │
├─────────────────────────────────────────────────┤
│  ⭐  Star the repo to show support              │
│  📝  Suggest a new tutorial via Issues           │
│  🔧  Fix errors or improve existing tutorials    │
│  📖  Write a new tutorial for a project          │
│  💬  Share feedback in Discussions                │
└─────────────────────────────────────────────────┘

What Makes a Great Tutorial?

Goes deep — explains how and why, not just what
Real code — examples from the actual codebase, not toy demos
Visual — architecture diagrams, flow charts, sequence diagrams
Progressive — builds complexity gradually across chapters
Production-focused — covers deployment, monitoring, scaling

Open an Issue to suggest a new tutorial or report a problem.

🌍 Community


⭐ Star this repo	Get updates on new tutorials
💬 Issues	Ask questions, report gaps, share suggestions
🐦 Twitter @johnxie	Latest updates and highlights

┌──────────────────────────────────────────────────┐
│                                                  │
│   "The best way to learn a codebase is to        │
│    understand the architecture decisions          │
│    that shaped it."                               │
│                                                  │
└──────────────────────────────────────────────────┘

Browse Tutorials · Pick a Learning Path · Star on GitHub

Name		Name	Last commit message	Last commit date
Latest commit History 238 Commits
.github		.github
categories		categories
discoverability		discoverability
formats		formats
scripts		scripts
templates		templates
tutorials		tutorials
.gitignore		.gitignore
CONTENT_GAPS_ANALYSIS.md		CONTENT_GAPS_ANALYSIS.md
CONTRIBUTING.md		CONTRIBUTING.md
IMPORT_ROADMAP_TODO.md		IMPORT_ROADMAP_TODO.md
LICENSE		LICENSE
README.md		README.md
TUTORIAL_STRUCTURE.md		TUTORIAL_STRUCTURE.md
llms-full.txt		llms-full.txt
llms.txt		llms.txt

License

johnxie/awesome-code-docs

Folders and files

Latest commit

History

Repository files navigation