vibes.diy Home
creator documentation

Build, script,
and ship.

Guides for making Vibes apps, wiring up backends, and deploying with the CLI. Every app you see on this site started from a prompt — these guides show you how to make one that's yours.

// concepts · explainer

What Is a Vibe?

A new unit of web software: where the webpage was a document and the SPA was an application, a vibe is a conjured, personal, shareable app — summoned by describing it, local by default, alive with AI, and composed from living starters and parts.

Read the explainer →
// guide

How to Make & Share an App

Step-by-step screenshot walkthrough — from prompt to live, shareable app in minutes. No coding required.

Read the guide →
// cli guide

CLI: npx vibes-diy generate

One command deploys a live React app from a prompt. 85 apps built this way. Read the workflow.

See the CLI →
// cli handbook

The CLI Handbook

Ship apps from the shell, script your data, tail changes live, manage secrets and versions, and mount your vibes into any AI agent over MCP.

Read the guide →
// cli reference

CLI Command Reference

Every vibes-diy command, subcommand, and flag — generated from the CLI's own help output.

Browse the commands →
// guide · backends

Your App Has a Backend

Ship a backend.js next to your app: webhook endpoints, write reactions, scheduled jobs, per-vibe secrets, outbound fetch, and server-side AI via ctx.callAI.

Read the guide →
// patterns

Patterns Cookbook

Production patterns from the vibes that run this platform: write-only credential vaults, doc-status state machines, CI lanes, self-rotating tokens, operator consoles, deploy buttons. Each one remixable.

Browse the patterns →
// data · use-vibes

Connect Backend Data

Read and write your app's live database from any JS backend — Node, Deno, Bun, or Cloudflare Workers.

Read the guide →
// concepts · platform

The Platform Handles the Rest

Generated apps write only their distinctive features — identity, access, sandboxing, data, and serving are platform substrate. Why that removes the prototype wall instead of making you climb it.

Read the principle →
// concepts · serving

How Your App Is Served

The path from URL to pixels: server-rendered first paint with your public data already in it, the edge cache and its freshness rules, deploy pins, and why private apps are never cached.

See the serve path →
// reference · generated

The Generator's Reference

The exact API docs the code generator reads — backend.js, Fireproof, callAI, ImgGen, and every creative skill — rendered fresh from platform source on every deploy.

Browse the reference →
// concepts · codegen

The System Prompts

The generator's prompts are open source on npm. What's in @vibes.diy/prompts, how they're assembled per app, and how to point your own model at them.

Read the prompts →
// api reference

Access API

Private channels, anonymous submissions, role-gated reads. One file controls who can write what and who can see it — server-enforced, no backend required.

Read the API reference →
// concepts · access

The Access Model

Accounts vs handles, channels vs grants vs roles, admin mode, and DMs — the conceptual map behind every sharing decision, with the traps labeled.

Read the concepts →
// guide

Local-first data & sync

Writes succeed locally and sync in the background. Learn what offline, revocation, blocking, and conflicts mean for your app's data.

Understand data & sync →
// spec · reference

Access Function Spec

The complete visual specification: the full API, worked use cases (onboarding, surveys, invite-only variants), and the per-database runtime architecture.

Open the spec →
// concepts · social

The Social Graph

The platform-wide follow graph: follow/followers semantics, private accounts, blocking, the useSocial() hook, and the audience field that makes a doc follower-visible.

Read the concepts →
// reference

Sharing & Access

Who sees your app. What they can do with it. Every grant state, Clone vs Remix, the pill, and all three sharing controls.

Read the reference →
// reference · sharing

Developer Grants

Delegate code edits — push, publish, codegen — on one vibe to another account while you keep grant/revoke, unpublish/delete, and ownership. Grant and revoke from the sharing panel or the CLI.

Read the reference →