# Bool

> Bool is an AI app builder: describe what you want in plain language and Bool writes the code, hosts it, and hands you a live URL in under a minute. It generates full-stack web apps (frontend, backend, and hosting) with no setup, no deploy step, and no repo to configure.

Bool turns a prompt into a running, shareable web app. You describe an idea, Bool builds it as a Vite + React app backed by a per-app database, and the result is live on our edge network the moment it builds. You keep iterating by editing in the browser or by telling Bool what to change — the URL stays the same and there is zero downtime between versions. Apps are free to share: anyone with the link can use them without signing up.

## What Bool does

- **Idea to URL in under a minute.** You describe it; Bool builds the frontend, backend, and hosting in one flow — a live URL to share before you'd finish setting up a repo.
- **Instantly shareable.** Every Bool gets a live URL on our edge network the moment it builds. There is no separate deploy step; it is already live.
- **Keep iterating.** Edit in the browser, tweak the prompt, or just say what to change. Same URL, new version, zero downtime.
- **Free to share.** Send the link. No sign-up is required for the people you share it with.

## How it works

1. Describe the app you want (e.g. "a polls app with realtime results" or "a habit tracker with streaks").
2. Bool generates a full-stack Vite + React application with a backing database and hosts it.
3. You get a live URL immediately and can share it or keep refining the app through chat or the in-browser editor.

## Building against Bool programmatically

Bool is usable as a backend from outside the editor: a CLI links a local project
to a real Bool, and `bool-sdk` (npm, stable since 0.3.0) is the client
for its database, end-user auth, and AI. If you are an agent writing code against
Bool, start with the SDK reference — it documents the whole surface on one page.

- `bool.entities.<table>` — table data. One-shot promises (`list`, `filter`, `get`,
  `create`, `update`, `delete`, `updateMany`, `deleteMany`) for scripts and event
  handlers, plus `useQuery()` for a live React view that stays current and applies
  optimistic writes.
- `bool.auth` — the app's own end-user accounts (supabase-js-shaped).
- `bool.ai` — text and JSON-Schema-validated generation with no API key of your own.
- Concurrency: put a precondition in `updateMany(query, ops)` and check `updated`;
  use `$inc` for counters. Never read-then-write.

## Documentation

- [Documentation home](https://bool.com/docs): All guides.
- [SDK reference](https://bool.com/docs/sdk-reference): Complete `bool-sdk` API — entities, live queries, filters, concurrency, auth, AI, storage, errors.
- [Develop locally (CLI)](https://bool.com/docs/cli): `bool create`, `link`, `types`, `entities push`, `deploy`; environment variables and keys.
- [Database](https://bool.com/docs/database): How data and live updates work.
- [Sign-in for your app's users](https://bool.com/docs/end-user-auth): End-user accounts.
- [Connect your AI (MCP)](https://bool.com/docs/mcp): Drive Bool from Claude or ChatGPT via the MCP server.
- [Building your app](https://bool.com/docs/building-your-app): How the agent works.
- [Publishing](https://bool.com/docs/publishing) and [Sharing](https://bool.com/docs/sharing): Going live and collaborators.

## Key pages

- [Home](https://bool.com/): What Bool is and how to start building.
- [Pricing](https://bool.com/pricing): Plans and limits.
- [Privacy Policy](https://bool.com/privacy): How user data is handled.
- [Terms of Service](https://bool.com/terms): Terms of use.

## Contact

- Email: hello@bool.com