Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CONTENT_GAPS_ANALYSIS.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ This document tracks structural and quality gaps that impact completeness and di

| Metric | Value |
|:-------|:------|
| Tutorial directories | 181 |
| Tutorials with exactly 8 numbered chapters | 178 |
| Tutorial directories | 183 |
| Tutorials with exactly 8 numbered chapters | 180 |
| Tutorials with >8 numbered chapters | 3 |
| Tutorials with 0 numbered chapters | 0 |
| Tutorials with partial chapter coverage (1-7) | 0 |
Expand Down
2 changes: 2 additions & 0 deletions IMPORT_ROADMAP_TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,8 @@ This roadmap tracks the next highest-impact tutorial imports for `awesome-code-d
| [`modelcontextprotocol/create-typescript-server`](https://github.com/modelcontextprotocol/create-typescript-server) | 100+ | P1 | `pack-bu` | done |
| [`TabbyML/tabby`](https://github.com/TabbyML/tabby) | 32k+ | P1 | `pack-bv` | done |
| [`Fission-AI/OpenSpec`](https://github.com/Fission-AI/OpenSpec) | 23k+ | P1 | `pack-bv` | done |
| [`sweepai/sweep`](https://github.com/sweepai/sweep) | 7k+ | P1 | `pack-bw` | done |
| [`stagewise-io/stagewise`](https://github.com/stagewise-io/stagewise) | 6k+ | P1 | `pack-bw` | done |

## P2 (Strategic Extensions)

Expand Down
32 changes: 18 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@

[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
[![GitHub stars](https://img.shields.io/github/stars/johnxie/awesome-code-docs?style=social)](https://github.com/johnxie/awesome-code-docs)
[![Tutorials](https://img.shields.io/badge/tutorials-181-brightgreen.svg)](#-tutorial-catalog)
[![Content Hours](https://img.shields.io/badge/content-1940%2B%20hours-orange.svg)](#-tutorial-catalog)
[![Tutorials](https://img.shields.io/badge/tutorials-183-brightgreen.svg)](#-tutorial-catalog)
[![Content Hours](https://img.shields.io/badge/content-1960%2B%20hours-orange.svg)](#-tutorial-catalog)
[![Last Updated](https://img.shields.io/github/last-commit/johnxie/awesome-code-docs?label=updated)](https://github.com/johnxie/awesome-code-docs/commits/main)

[**Browse Tutorials**](#-tutorial-catalog) · [**A-Z Directory**](discoverability/tutorial-directory.md) · [**Learning Paths**](#-learning-paths) · [**Contributing**](#-contributing) · [**Community**](#-community)
Expand Down Expand Up @@ -63,7 +63,7 @@ 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](tutorials/cline-tutorial/) | [Roo Code](tutorials/roo-code-tutorial/) → [OpenCode](tutorials/opencode-tutorial/) → [Tabby](tutorials/tabby-tutorial/) → [bolt.diy](tutorials/bolt-diy-tutorial/) → [VibeSDK](tutorials/vibesdk-tutorial/) → [HAPI](tutorials/hapi-tutorial/) |
| open-source vibe coding tools | [Cline](tutorials/cline-tutorial/) | [Roo Code](tutorials/roo-code-tutorial/) → [OpenCode](tutorials/opencode-tutorial/) → [Sweep](tutorials/sweep-tutorial/) → [Tabby](tutorials/tabby-tutorial/) → [Stagewise](tutorials/stagewise-tutorial/) → [bolt.diy](tutorials/bolt-diy-tutorial/) → [VibeSDK](tutorials/vibesdk-tutorial/) → [HAPI](tutorials/hapi-tutorial/) |
| spec-driven AI delivery workflows | [OpenSpec](tutorials/openspec-tutorial/) | [Claude Task Master](tutorials/claude-task-master-tutorial/) → [Codex CLI](tutorials/codex-cli-tutorial/) → [OpenCode](tutorials/opencode-tutorial/) |
| build AI agents in production | [LangChain](tutorials/langchain-tutorial/) | [LangGraph](tutorials/langgraph-tutorial/) → [CrewAI](tutorials/crewai-tutorial/) → [OpenHands](tutorials/openhands-tutorial/) → [Claude Flow](tutorials/claude-flow-tutorial/) |
| build RAG systems | [LlamaIndex](tutorials/llamaindex-tutorial/) | [Haystack](tutorials/haystack-tutorial/) → [RAGFlow](tutorials/ragflow-tutorial/) |
Expand All @@ -87,7 +87,9 @@ This section tracks high-impact open-source vibe-coding and coding-agent ecosyst
| [`RooCodeInc/Roo-Code`](https://github.com/RooCodeInc/Roo-Code) | [Roo Code Tutorial](tutorials/roo-code-tutorial/) | 22,198 | multi-mode coding agents and approval workflows |
| [`continuedev/continue`](https://github.com/continuedev/continue) | [Continue Tutorial](tutorials/continue-tutorial/) | 31,348 | IDE-native AI coding assistant architecture |
| [`anomalyco/opencode`](https://github.com/anomalyco/opencode) | [OpenCode Tutorial](tutorials/opencode-tutorial/) | 103,218 | terminal-native coding agent with strong provider and tool controls |
| [`sweepai/sweep`](https://github.com/sweepai/sweep) | [Sweep Tutorial](tutorials/sweep-tutorial/) | 7,636 | issue-to-PR coding agent workflows and self-hosted GitHub automation patterns |
| [`TabbyML/tabby`](https://github.com/TabbyML/tabby) | [Tabby Tutorial](tutorials/tabby-tutorial/) | 32,884 | self-hosted coding assistant platform for teams and enterprises |
| [`stagewise-io/stagewise`](https://github.com/stagewise-io/stagewise) | [Stagewise Tutorial](tutorials/stagewise-tutorial/) | 6,494 | browser-context frontend coding agent workflows with plugin and bridge architecture |
| [`Fission-AI/OpenSpec`](https://github.com/Fission-AI/OpenSpec) | [OpenSpec Tutorial](tutorials/openspec-tutorial/) | 23,765 | spec-driven workflow layer for predictable AI-assisted delivery |
| [`Nano-Collective/nanocoder`](https://github.com/Nano-Collective/nanocoder) | [Nanocoder Tutorial](tutorials/nanocoder-tutorial/) | 1,318 | local-first coding-agent internals and tool loops |
| [`browser-use/browser-use`](https://github.com/browser-use/browser-use) | [Browser Use Tutorial](tutorials/browser-use-tutorial/) | 78,191 | browser-native AI automation and agent execution |
Expand All @@ -101,7 +103,7 @@ This section tracks high-impact open-source vibe-coding and coding-agent ecosyst
```
╔════════════════════════════════════════════════════════════╗
║ 🤖 AI & AGENTS │ 🔧 DEV TOOLS │ 🗄️ DATA │ 🎤 SPEECH ║
║ 67+ tutorials │ 41 tutorials │ 14 tutorials │ 3 tutorials ║
║ 67+ tutorials │ 43 tutorials │ 14 tutorials │ 3 tutorials ║
╚════════════════════════════════════════════════════════════╝
```

Expand Down Expand Up @@ -204,7 +206,9 @@ AI coding assistants, build systems, and dev infrastructure.
| **[Cline](tutorials/cline-tutorial/)** | 58K+ | TypeScript/VS Code | Agentic coding with terminal, browser, MCP tools |
| **[Roo Code](tutorials/roo-code-tutorial/)** | 22K+ | TypeScript/VS Code | Multi-mode coding agents with checkpoints and MCP |
| **[OpenCode](tutorials/opencode-tutorial/)** | 103.2K+ | Go/TypeScript | Terminal-native coding agent architecture, provider routing, and tool safety controls |
| **[Sweep](tutorials/sweep-tutorial/)** | 7.6K+ | Python/GitHub | Issue-to-PR coding agent workflow with config-driven governance and CI feedback loops |
| **[Tabby](tutorials/tabby-tutorial/)** | 32.9K+ | Rust/TypeScript | Self-hosted code completion and answer platform with editor-agent integrations |
| **[Stagewise](tutorials/stagewise-tutorial/)** | 6.5K+ | TypeScript/CLI | Frontend coding agent proxy with browser context selection, bridge mode, and plugin runtime |
| **[OpenSpec](tutorials/openspec-tutorial/)** | 23.8K+ | TypeScript/CLI | Spec-driven artifact workflow for planning, implementation, validation, and archive governance |
| **[bolt.diy](tutorials/bolt-diy-tutorial/)** | 19K+ | TypeScript/Remix | Open-source Bolt-style AI app builder |
| **[Cloudflare VibeSDK](tutorials/vibesdk-tutorial/)** | 4.7K+ | TypeScript/Cloudflare | Build and operate a cloud-native vibe-coding platform |
Expand Down Expand Up @@ -368,9 +372,9 @@ llama.cpp ──→ vLLM ──→ LiteLLM ──→ BentoML ──→ K8s Opera
> *"I want to understand how AI coding assistants work"*

```
Continue ──→ Aider ──→ OpenHands ──→ OpenCode ──→ Tabby ──→ OpenSpec
(code (pair (AI SWE (terminal (self-hosted (spec-driven
completion) prog) agent) coding agent) assistant) delivery)
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
Expand Down Expand Up @@ -415,9 +419,9 @@ OpenAI Python SDK ──→ tiktoken ──→ OpenAI Whisper ──→ Realtime
> *"I want to build and operate vibe-coding stacks end to end"*

```
Dyad ──→ bolt.diy ──→ Cline ──→ Roo Code ──→ VibeSDK ──→ HAPI
(local (OSS app (IDE (multi-mode (cloud (remote
builder) builder) agent) dev team) platform) approvals)
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
Expand All @@ -430,10 +434,10 @@ Dyad ──→ bolt.diy ──→ Cline ──→ Roo Code ──→ VibeSDK ─
╔══════════════════════════════════════════════════════════╗
║ COLLECTION OVERVIEW ║
╠══════════════════════════════════════════════════════════╣
║ 📦 Total Tutorials 181
║ 📝 Numbered Chapters 1,451
║ 📏 Tutorial Markdown 475,000+ lines ║
║ ⏱️ Estimated Hours 1,940+ ║
║ 📦 Total Tutorials 183
║ 📝 Numbered Chapters 1,467
║ 📏 Tutorial Markdown 476,000+ lines ║
║ ⏱️ Estimated Hours 1,960+ ║
║ ✅ Local Broken Links 0 ║
║ 🧭 Structure Drift 0 (all root canonical) ║
╚══════════════════════════════════════════════════════════╝
Expand Down
2 changes: 1 addition & 1 deletion TUTORIAL_STRUCTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ tutorials/<tutorial-name>/

| Pattern | Count |
|:--------|:------|
| `root_only` | 181 |
| `root_only` | 183 |
| `docs_only` | 0 |
| `index_only` | 0 |
| `mixed` | 0 |
Expand Down
6 changes: 4 additions & 2 deletions categories/ai-ml-platforms.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

## Snapshot (February 12, 2026)

- repository-wide tutorials: **181**
- repository-wide tutorials: **183**
- AI/agent + developer-tooling coverage: **largest cluster in the catalog**
- canonical structure status: **all tracks publish full chapter sets**

Expand All @@ -13,7 +13,7 @@
| Goal | Recommended Starting Tutorial | Next Tutorials |
|:-----|:------------------------------|:---------------|
| Build autonomous AI agents | [LangChain](../tutorials/langchain-tutorial/) | [LangGraph](../tutorials/langgraph-tutorial/) → [CrewAI](../tutorials/crewai-tutorial/) → [Claude Flow](../tutorials/claude-flow-tutorial/) |
| Understand AI coding agents | [Cline](../tutorials/cline-tutorial/) | [Roo Code](../tutorials/roo-code-tutorial/) → [OpenCode](../tutorials/opencode-tutorial/) → [Tabby](../tutorials/tabby-tutorial/) → [OpenHands](../tutorials/openhands-tutorial/) |
| Understand AI coding agents | [Cline](../tutorials/cline-tutorial/) | [Roo Code](../tutorials/roo-code-tutorial/) → [OpenCode](../tutorials/opencode-tutorial/) → [Sweep](../tutorials/sweep-tutorial/) → [Tabby](../tutorials/tabby-tutorial/) → [Stagewise](../tutorials/stagewise-tutorial/) → [OpenHands](../tutorials/openhands-tutorial/) |
| Build vibe-coding products | [Dyad](../tutorials/dyad-tutorial/) | [bolt.diy](../tutorials/bolt-diy-tutorial/) → [VibeSDK](../tutorials/vibesdk-tutorial/) → [HAPI](../tutorials/hapi-tutorial/) |
| Run spec-driven AI delivery workflows | [OpenSpec](../tutorials/openspec-tutorial/) | [Claude Task Master](../tutorials/claude-task-master-tutorial/) → [Codex CLI](../tutorials/codex-cli-tutorial/) |
| Build RAG systems | [LlamaIndex](../tutorials/llamaindex-tutorial/) | [Haystack](../tutorials/haystack-tutorial/) → [RAGFlow](../tutorials/ragflow-tutorial/) |
Expand All @@ -26,7 +26,9 @@
- [LangGraph](../tutorials/langgraph-tutorial/)
- [OpenHands](../tutorials/openhands-tutorial/)
- [OpenCode](../tutorials/opencode-tutorial/)
- [Sweep](../tutorials/sweep-tutorial/)
- [Tabby](../tutorials/tabby-tutorial/)
- [Stagewise](../tutorials/stagewise-tutorial/)
- [OpenSpec](../tutorials/openspec-tutorial/)
- [Vercel AI SDK](../tutorials/vercel-ai-tutorial/)
- [Composio](../tutorials/composio-tutorial/)
Expand Down
3 changes: 2 additions & 1 deletion categories/web-frameworks.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,14 @@
| Build AI apps with TypeScript | [Vercel AI SDK](../tutorials/vercel-ai-tutorial/) | [CopilotKit](../tutorials/copilotkit-tutorial/) → [LobeChat](../tutorials/lobechat-ai-platform/) |
| Build chat/product interfaces | [Chatbox](../tutorials/chatbox-tutorial/) | [Open WebUI](../tutorials/open-webui-tutorial/) → [Perplexica](../tutorials/perplexica-tutorial/) |
| Understand visual workflow products | [Flowise](../tutorials/flowise-llm-orchestration/) | [Dify](../tutorials/dify-platform-deep-dive/) |
| Build with vibe-coding UX patterns | [bolt.diy](../tutorials/bolt-diy-tutorial/) | [Dyad](../tutorials/dyad-tutorial/) → [VibeSDK](../tutorials/vibesdk-tutorial/) |
| Build with vibe-coding UX patterns | [Stagewise](../tutorials/stagewise-tutorial/) | [Dyad](../tutorials/dyad-tutorial/) → [bolt.diy](../tutorials/bolt-diy-tutorial/) → [VibeSDK](../tutorials/vibesdk-tutorial/) |

## Featured Framework/App Tracks

- [Vercel AI SDK](../tutorials/vercel-ai-tutorial/)
- [CopilotKit](../tutorials/copilotkit-tutorial/)
- [LobeChat](../tutorials/lobechat-ai-platform/)
- [Stagewise](../tutorials/stagewise-tutorial/)
- [Flowise](../tutorials/flowise-llm-orchestration/)
- [Dify](../tutorials/dify-platform-deep-dive/)

Expand Down
6 changes: 5 additions & 1 deletion discoverability/tutorial-directory.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

This page is auto-generated from the tutorial index and is intended as a fast browse surface for contributors and search crawlers.

- Total tutorials: **181**
- Total tutorials: **183**
- Source: `scripts/generate_discoverability_assets.py`

## A
Expand Down Expand Up @@ -386,6 +386,8 @@ This page is auto-generated from the tutorial index and is intended as a fast br
- A deep technical walkthrough of SiYuan covering Privacy-First Knowledge Management.
- [Smolagents Tutorial: Hugging Face's Lightweight Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/smolagents-tutorial/index.md)
- Build efficient AI agents with minimal code using Hugging Face's smolagents library.
- [Stagewise Tutorial: Frontend Coding Agent Workflows in Real Browser Context](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/index.md)
- Learn how to use `stagewise-io/stagewise` to connect browser-selected UI context with coding agents, plugin extensions, and multi-agent bridge workflows.
- [Strands Agents Tutorial: Model-Driven Agent Systems with Native MCP Support](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/strands-agents-tutorial/index.md)
- Learn how to use `strands-agents/sdk-python` to build lightweight, model-driven agents with strong tool abstractions, hooks, and production deployment patterns.
- [Supabase Tutorial: Building Modern Backend Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/index.md)
Expand All @@ -396,6 +398,8 @@ This page is auto-generated from the tutorial index and is intended as a fast br
- Learn how to use `superset-sh/superset` to orchestrate many coding agents in parallel with worktree isolation, centralized monitoring, and fast review loops.
- [SWE-agent Tutorial: Autonomous Repository Repair and Benchmark-Driven Engineering](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swe-agent-tutorial/index.md)
- Learn how to use `SWE-agent/SWE-agent` for autonomous software engineering workflows, from single-issue runs to benchmark and research-grade evaluation.
- [Sweep Tutorial: Issue-to-PR AI Coding Workflows on GitHub](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/index.md)
- Learn how to use `sweepai/sweep` to turn GitHub issues into pull requests, operate feedback loops, and run self-hosted or CLI workflows with clear guardrails.

## T

Expand Down
59 changes: 58 additions & 1 deletion discoverability/tutorial-index.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"project": "awesome-code-docs",
"tutorial_count": 181,
"tutorial_count": 183,
"tutorials": [
{
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/index.md",
Expand Down Expand Up @@ -4348,6 +4348,34 @@
"summary": "Build efficient AI agents with minimal code using Hugging Face's smolagents library.",
"title": "Smolagents Tutorial: Hugging Face's Lightweight Agent Framework"
},
{
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/index.md",
"index_path": "tutorials/stagewise-tutorial/index.md",
"keywords": [
"stagewise",
"frontend",
"coding",
"agent",
"workflows",
"real",
"browser",
"context",
"learn",
"use",
"connect",
"selected",
"agents",
"plugin",
"extensions",
"multi",
"bridge"
],
"path": "tutorials/stagewise-tutorial",
"repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/stagewise-tutorial",
"slug": "stagewise-tutorial",
"summary": "Learn how to use `stagewise-io/stagewise` to connect browser-selected UI context with coding agents, plugin extensions, and multi-agent bridge workflows.",
"title": "Stagewise Tutorial: Frontend Coding Agent Workflows in Real Browser Context"
},
{
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/strands-agents-tutorial/index.md",
"index_path": "tutorials/strands-agents-tutorial/index.md",
Expand Down Expand Up @@ -4488,6 +4516,35 @@
"summary": "Learn how to use `SWE-agent/SWE-agent` for autonomous software engineering workflows, from single-issue runs to benchmark and research-grade evaluation.",
"title": "SWE-agent Tutorial: Autonomous Repository Repair and Benchmark-Driven Engineering"
},
{
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/index.md",
"index_path": "tutorials/sweep-tutorial/index.md",
"keywords": [
"sweep",
"issue",
"coding",
"workflows",
"learn",
"use",
"sweepai",
"turn",
"issues",
"into",
"pull",
"requests",
"operate",
"feedback",
"loops",
"run",
"self",
"hosted"
],
"path": "tutorials/sweep-tutorial",
"repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/sweep-tutorial",
"slug": "sweep-tutorial",
"summary": "Learn how to use `sweepai/sweep` to turn GitHub issues into pull requests, operate feedback loops, and run self-hosted or CLI workflows with clear guardrails.",
"title": "Sweep Tutorial: Issue-to-PR AI Coding Workflows on GitHub"
},
{
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/index.md",
"index_path": "tutorials/tabby-tutorial/index.md",
Expand Down
Loading