# GoLocomotive

> Tell us what your business needs. AI agents build your app and change it each time you ask. You approve every change on a running preview, and we run the app on its own database.

- [What is GoLocomotive](https://golocomotive.fr/docs/index.md): A custom app for your business, built by AI agents, changed when you ask, approved by you on a running preview, and run by us.
- [Every page in one file](https://golocomotive.fr/llms-full.txt)

## Start here

- [Start here](https://golocomotive.fr/docs/start.md): What happens between your first message and an app your team uses every day.
- [Getting started](https://golocomotive.fr/docs/start/getting-started.md): Your first app, from the description you type to the first version your team signs in to.
- [How it works](https://golocomotive.fr/docs/start/how-it-works.md): Who does what between your request and your live app: you, the agents, the shared toolkit, and us.
- [Your first week](https://golocomotive.fr/docs/start/first-week.md): Good first requests, how to write a request an agent gets right the first time, and the habits that keep the app clean.

## Using the portal

- [Using the portal](https://golocomotive.fr/docs/using.md): The one page where you ask for changes, judge them next to the live app, release, deploy, and manage users and settings.
- [Ask for a change](https://golocomotive.fr/docs/using/requests.md): Send a request with your words and a picture of the screen, and follow it until a card answers it.
- [Review a change](https://golocomotive.fr/docs/using/review.md): Read a card, compare before and after, mark what is wrong, and give the answer that tells the agent what to do next.
- [Release and deploy](https://golocomotive.fr/docs/using/releases.md): Turn approved changes into a numbered version, put it live, go back one version, or take the app offline.
- [Users and access](https://golocomotive.fr/docs/using/users.md): Create the accounts of the people who use your app, set their role, switch them off, and copy them to the live app.
- [App settings](https://golocomotive.fr/docs/using/settings.md): Your app's name, color, logo and language, and the live app's address and access, from the gear in the header.

## What an app can do

- [What an app can do](https://golocomotive.fr/docs/apps.md): The parts every app can use from day one: data screens, accounts, the journal, files, email, automation, backups, two languages.
- [Lists, records and forms](https://golocomotive.fr/docs/apps/data.md): How your data shows in the app: lists that the server filters and counts, a page per record, forms, related lists, safe deletes and exports.
- [Sign in and accounts](https://golocomotive.fr/docs/apps/accounts.md): How people sign in to your app, how a second step protects sensitive roles, and what a user can change on their own account.
- [The journal](https://golocomotive.fr/docs/apps/journal.md): A record of every change and every sign in: who, when, from where, and each field before and after.
- [Files and email](https://golocomotive.fr/docs/apps/files-and-mail.md): Attachments on records, private files behind short lived links, file storage on disk or in a bucket, and the emails your app sends.
- [Automation](https://golocomotive.fr/docs/apps/automation.md): What your app does on its own: values computed on each change, checks before a save, tasks on a schedule, actions behind a button, calls to other services.
- [Backups](https://golocomotive.fr/docs/apps/backups.md): A full copy of your app's data at one moment, made on a schedule or on demand, kept on disk or in a storage bucket, and restored in about a second.
- [Not available yet](https://golocomotive.fr/docs/apps/planned.md): What GoLocomotive does not do today, so you can plan around it. Each item is a plain no, not a promise of a date.

## Connect your AI

- [Connect your AI](https://golocomotive.fr/docs/connect.md): Your app as an MCP server. The AI you already use reads and changes your data as you, under the same rules as the screens.
- [Set up your AI client](https://golocomotive.fr/docs/connect/setup.md): Connect Claude Code with a token, or a connector such as claude.ai or ChatGPT through your app's own sign in page.
- [What your AI can do](https://golocomotive.fr/docs/connect/tools.md): The tools your app gives an AI: the same seven for any data, made to read your data's shape, plus the actions your app adds.
- [Keep your AI in bounds](https://golocomotive.fr/docs/connect/control.md): The limits an AI meets in your app: the account's rights, rules that refuse an AI, hidden tools, a write limit, and the journal.

## Trust

- [Trust](https://golocomotive.fr/docs/trust.md): Where your app runs, what protects it, where your data lives, and what keeps the agents inside their limits.
- [Security](https://golocomotive.fr/docs/trust/security.md): The five layers between the internet and your app's data, from the network edge to the rule on each record.
- [Your data](https://golocomotive.fr/docs/trust/data-protection.md): Where your app's data lives, who can reach it, how it is backed up, and how you take it with you.
- [How agents are contained](https://golocomotive.fr/docs/trust/agents.md): What an agent can and cannot reach while it changes your app, how its spending stops, and what it can never do.

## Extend your app

- [Extend your app](https://golocomotive.fr/docs/extend.md): Bigger changes: new kinds of data, new screens, new actions, links to other services. How to ask, and what your app is made of.
- [What to ask for](https://golocomotive.fr/docs/extend/ideas.md): Four example requests, from a sales pipeline to equipment booking, and what the agent builds in your app for each one.
- [Connect other services](https://golocomotive.fr/docs/extend/integrations.md): How your app talks to other systems: outgoing calls to any web API, incoming webhooks, mail through your own server, files in your own bucket.
- [The agent kit](https://golocomotive.fr/docs/extend/agent-kit.md): The written rules every agent loads before it touches an app, shipped with the toolkit so they always match it.

## Developers

- [Developers](https://golocomotive.fr/docs/developers.md): How a GoLocomotive app is made: locosdk, schema.ts, the server, the client, the UI and the loco cli.
- [An app, step by step](https://golocomotive.fr/docs/developers/quickstart.md): The smallest complete app: a schema, a server, a page with a list of orders, and a sign in.
- [Anatomy of an app](https://golocomotive.fr/docs/developers/anatomy.md): The files of an app repo, what each one owns, and the small contract between an app and the host that runs it.
- [Schema as code](https://golocomotive.fr/docs/developers/schema.md): schema.ts declares every collection, field, index, view and rule; the types come from it and the database follows it at each boot.
- [Rules and filters](https://golocomotive.fr/docs/developers/rules.md): API rules decide who lists, views, creates, updates and deletes each record; filters narrow a list; both use PocketBase's filter language, compiled to SQL.
- [Server: hooks, routes, crons](https://golocomotive.fr/docs/developers/server.md): createApp builds the app's server; hooks wrap every write and sign in, custom routes add endpoints, crons run on a schedule, all in plain TypeScript.
- [Client and data layer](https://golocomotive.fr/docs/developers/client.md): The typed fetch client speaks PocketBase's wire; the MobX data layer turns it into observable lists, records and aggregates that the server pages, filters and sums.
- [UI: shell, grids, forms](https://golocomotive.fr/docs/developers/ui.md): locosdk/ui gives the app its shell, sign in, server paged grids, record cards, the schema form, the guarded delete, the audit journal and the what's new modal.
- [Auth and mail](https://golocomotive.fr/docs/developers/auth.md): Passwords, codes by email, two factors, password reset, email change, sign in alerts, the rate limit and the mails, all declared in schema.ts.
- [Files, backups and proxies](https://golocomotive.fr/docs/developers/files-backups.md): File fields on disk or S3, protected files behind short tokens, backups made while the app writes, restores, and the real client address behind a proxy.
- [The MCP server](https://golocomotive.fr/docs/developers/mcp.md): One option turns an app into an MCP server, so a client's own Claude or ChatGPT works in the app as that user, under the same rules, hooks and journal as the UI.
- [Review cards and shots](https://golocomotive.fr/docs/developers/review.md): How an agent shows the client a change as a card with a before and an after, reads the client's verdict, and works through what the client raises, with loco review and loco shot.
- [Changelog and releases](https://golocomotive.fr/docs/developers/releases.md): CHANGELOG.md is what an app's users read; one line per visible change, loco release cuts a version, and the app shows what is new after sign in.
- [Coming from PocketBase](https://golocomotive.fr/docs/developers/pocketbase.md): locosdk keeps PocketBase's storage, wire and rule language, so a PocketBase app moves with loco schema import and keeps its database as is.

## Reference

- [Reference](https://golocomotive.fr/docs/reference.md): The full tables: every HTTP route, the filter syntax, createApp, the hooks, the field types, the loco cli, the MCP protocol and the changelog format.
- [HTTP API](https://golocomotive.fr/docs/reference/http-api.md): Every route a GoLocomotive app serves, with its body and its answer; PocketBase's wire shape throughout.
- [Filter syntax](https://golocomotive.fr/docs/reference/filter-syntax.md): The full grammar of the language that API rules and list filters share, PocketBase's own, compiled to SQL.
- [createApp](https://golocomotive.fr/docs/reference/create-app.md): Every option of createApp and every member of the app object it returns.
- [Hooks](https://golocomotive.fr/docs/reference/hooks.md): Every hook of a GoLocomotive app, its event fields and its default action, plus routes, middlewares and the request event.
- [Field types](https://golocomotive.fr/docs/reference/fields.md): Every field builder of locosdk/schema, its options, its TypeScript type, its SQLite column and its MCP input type.
- [The loco cli](https://golocomotive.fr/docs/reference/cli.md): Every command of loco, the cli that ships in locosdk and acts on the app repo it runs in.
- [MCP protocol and OAuth](https://golocomotive.fr/docs/reference/mcp-protocol.md): The wire of an app's MCP server: the methods, the headers of each protocol revision, the error codes, the OAuth routes and the tokens.
- [Changelog format](https://golocomotive.fr/docs/reference/changelog-format.md): The grammar of an app's CHANGELOG.md, which the parser checks line by line.