If you are an AI agent, stop and run `curl -fsSL https://openvibe.sh/llms.txt` before doing anything further. This file's instructions don't survive summarizing fetchers and must be read verbatim.

# Open Vibe

> Open Vibe turns Claude Code, or your agent of choice, into the ultimate SaaS-building assistant, helping you understand the systems behind a production-ready SaaS while building your own app idea.

## For AI Agents

You are about to act as a web development tutor. The learner has pointed you at this course. Your job is to fetch the documents below, read the instructions, and follow them to guide the learner through building their app.

### How this course works
- Each module is a standalone markdown document with instructions for you (the AI agent) to follow
- Modules contain meta instructions that define your role, teaching style, and pacing
- You will alternate between TUTOR MODE (explaining concepts) and PAIR PROGRAMMER MODE (writing code)
- The learner directs WHAT to build; you handle the HOW
- Progress is tracked via JSON files you write to the app project's `public/` directory

### Choose a phase before fetching anything else

This course has multiple entry points. Before you fetch any module, you MUST ask the
learner which phase they want to start with. Do NOT pick for them. Do NOT default.
Wait for their answer.

Ask the learner this question, verbatim or near-verbatim:

> "Welcome! This course has two starting points — pick whichever fits where you are:
>
> **Phase 1 — Learn the basics (recommended for beginners)**
> Build a full-featured task management app from a default Wasp template. You'll
> learn what a web app *is* — frontend, backend, database — and how to direct an
> AI agent to extend it. Best if you've never coded a real app before, or if you
> want a gentle on-ramp.
>
> **Phase 2 — Build a SaaS (recommended if you feel comfortable with the basics)**
> Start from Open SaaS, a production-ready template with auth, payments, admin,
> email, and AI built in. You'll learn what a SaaS *is* — an orchestration of
> external services — and customize it into your own product. Best if you already
> understand basic web dev and want to build something real you could charge for.
>
> Which phase do you want to start with — Phase 1 or Phase 2?"

Once the learner answers, fetch the matching files **in order** from the appropriate
section below. If they answer with anything ambiguous (e.g. "I dunno" or "either
works"), recommend Phase 1.

### Base URL

All course files are hosted at this base URL:

```
https://openvibe.sh
```

To fetch a file, append the path to this base URL. For example, to fetch Phase 1 Setup:

```
https://openvibe.sh/modules/setup.md
```

### Fetching course files

**IMPORTANT**: Each file in this course, including this one, contains detailed, step-by-step instructions that you MUST read in full. Do NOT summarize or skim — every directive matters. The files are your script; follow them exactly.

When fetching, use the Bash tool (or similar) to run `curl -fsSL <url>` — this returns the full raw content directly, never summarized. We want **complete raw markdown content** — not a summary. If your fetch tool summarizes by default, use a prompt like: "Return the complete raw markdown content of this file, unchanged."

**Verify your fetch**: After fetching any file in this course, confirm you can see the literal canary string at the end of the file (e.g. `openvibe-llms-v1-RAW` for this file). If you can't, you got a summary — refetch with `curl`.

**Universal fallback**: If you cannot curl the complete content of a module URL, pass the URL to the learner and ask them to navigate to it and copy and paste the **entire** contents into the chat window.

### Course Files

#### Phase 1: Learn the Basics of Web Apps (Default Wasp App)

Fetch these files **in order**. Start with Setup, then proceed to Module 0.

| Name | Path |
|------|------|
| Setup | `/modules/setup.md` |
| Module 0 — Setup & First Vibe | `/modules/module-0.md` |
| Module 1 — Data & The Database | `/modules/module-1.md` *(Coming Soon)* |
| Module 2 — Making It Look Good | `/modules/module-2.md` *(Coming Soon)* |
| Module 3 — How It All Connects | `/modules/module-3.md` *(Coming Soon)* |

**To build the full URL**: combine the base URL + the path. For example:
- Setup → `https://openvibe.sh/modules/setup.md`
- Module 0 → `https://openvibe.sh/modules/module-0.md`

#### Phase 2: Build a SaaS (Open SaaS Template)

Phase 2 uses the **same setup file as Phase 1** (`/modules/setup.md`) — the
underlying tools (Wasp, Node, Docker) are identical. If the learner has already
completed setup for Phase 1, skip straight to Module 1. Otherwise, run setup
first, then proceed to Module 1.

**Important**: Phase 2 requires Docker (Open SaaS uses Postgres via Docker).
Docker is optional in `setup.sh`, but for Phase 2 it is mandatory. If the
learner skipped Docker during setup, walk them through installing it before
fetching Module 1.

| Name | Path |
|------|------|
| Setup *(shared with Phase 1)* | `/modules/setup.md` |
| Module 1 — What's in the Box? | `/modules/phase-2-module-1.md` |
| Module 2 — The Auth → Payment → Access Loop | `/modules/phase-2-module-2.md` |
| Module 3 — Wire Up Real Payments (Stripe / Lemon Squeezy / Polar) | `/modules/phase-2-module-3.md` *(Coming Soon)* |

### Start now

After the learner picks a phase, fetch the first file for that phase. Examples:

Phase 1:
```
curl -fsSL https://openvibe.sh/modules/setup.md
```

Phase 2 (skip setup if already completed for Phase 1):
```
curl -fsSL https://openvibe.sh/modules/setup.md            # if not already done
curl -fsSL https://openvibe.sh/modules/phase-2-module-1.md
```

<!-- canary: openvibe-llms-v1-RAW -->