Skip to content

README.md

Latest commit

 

History

History
112 lines (84 loc) · 5.3 KB

README.md

File metadata and controls

112 lines (84 loc) · 5.3 KB
layout default
title Bolt.diy Tutorial
nav_order 96
has_children true
format_version v2

bolt.diy Tutorial: Build and Operate an Open Source AI App Builder

A production-focused deep dive into stackblitz-labs/bolt.diy: architecture, provider routing, safe edit loops, MCP integrations, deployment choices, and operational governance.

GitHub Repo License: MIT Docs

Why This Tutorial Exists

Most bolt.diy guides stop at setup. This track is for engineers and teams that want to:

  • run bolt.diy reliably across local, container, and hosted environments
  • enforce safe human-in-the-loop change controls for generated code
  • connect MCP tools and backend services without creating governance debt
  • choose practical deployment and operations patterns for real teams

Current Snapshot (auto-updated)

Mental Model

flowchart LR
    U[User Intent] --> P[Prompt + Constraints]
    P --> M[Model Provider Routing]
    M --> G[Generated Plan and Code Changes]
    G --> D[Diff and File Controls]
    D --> T[Runtime Validation]
    T --> I[Iterative Repair]
    I --> R[Deployment and Release]
    R --> O[Operations and Governance]
Loading

Learning Path

Chapter Core Question What You Build
01 - Getting Started How do we get a reliable local baseline fast? Local and Docker-first setup + first safe task
02 - Architecture Overview How is bolt.diy organized internally? A practical map of runtime and code boundaries
03 - Providers and Routing How should model/provider selection be governed? Provider policy, fallback chains, and cost controls
04 - Prompt-to-App Workflow How do prompts become reviewable product changes? A deterministic prompt-review-validate loop
05 - Files, Diff, and Locking How do we keep generated edits safe? Diff review standards and high-risk file controls
06 - Integrations and MCP How do we connect tools and services without chaos? MCP + integration rollout strategy and contracts
07 - Deployment and Distribution Which runtime target should we pick and why? Deployment matrix for web, container, and desktop
08 - Production Operations What does production readiness look like? SLOs, observability, incident playbooks, and audits

Skill Outcomes

By the end of this track, you should be able to:

  • run bolt.diy in a reproducible dev environment with clear guardrails
  • choose provider/model defaults by task class and policy constraints
  • structure AI-assisted edits into auditable, low-risk delivery loops
  • integrate external tools with explicit schemas and approval boundaries
  • ship and operate bolt.diy with measurable reliability and rollback paths

Suggested Prerequisites

  • Comfortable with Git workflows, code review, and CI/CD basics
  • Basic knowledge of Node.js, package managers, and environment variables
  • Familiarity with LLM provider APIs and secret management fundamentals

Source References

Related Tutorials

Start with Chapter 1: Getting Started.

Navigation & Backlinks

Full Chapter Map

  1. Chapter 1: Getting Started
  2. Chapter 2: Architecture Overview
  3. Chapter 3: Providers and Model Routing
  4. Chapter 4: Prompt-to-App Workflow
  5. Chapter 5: Files, Diff, and Locking
  6. Chapter 6: Integrations and MCP
  7. Chapter 7: Deployment and Distribution
  8. Chapter 8: Production Operations

Generated by AI Codebase Knowledge Builder