# Remy developer docs

> For developers building Remy. Elsewhere: Product guide, for people using the app: https://remy-auth-docs.gedw99.workers.dev/docs/llms.txt; API reference, for developers calling the API: https://remy-auth-docs.gedw99.workers.dev/reference/llms.txt. Everything: https://remy-auth-docs.gedw99.workers.dev/llms.txt.

- [Developers: start here](/dev): For developers building Remy or an app on it: shared authentication for Remy apps, Better Auth on Cloudflare Workers, the shared remy-ui package, and where to start.
- [Agents: start here](/dev/agents): Where an AI agent starts in this repository: the documents that own the rules, in reading order, the live sites, and the flow every piece of work goes through.
- [Architecture and development principles](/dev/development): What the code must be: ownership, a single source of truth, test gates, generated code and owner decisions.
- [How we work](/dev/how-we-work): How people and agents work here: project tools first, surveys before tool choices, shadcn and TanStack, gates, plans and translations.
- [Developer tooling reference](/dev/tooling): The developer tooling reference: the package.json scripts and the remy commands, pinned tools, secrets, agent skills and the Cloudflare services behind the docs.
- [Minimal GUI proof](/dev/gui): One Cloudflare Worker serves the site and the app; how to run it locally, preview it and test it against local and remote targets.
- [@joeblew999/remy-ui](/dev/ui-package): The UI every Remy app shares: stock shadcn, fonts, Paraglide catalogs, the site and app pages, TanStack Start glue and its checks.
- [Sign-in and permissions](/dev/auth): How a Remy app gets sign-in, roles and relationship-based permissions from remy-auth and its package: the guard, the relation engine, the Allowed component, environments, mail, and the checks each brings.
- [The command line](/dev/tasks): remy, the tooling every Remy app installs with the package: the scripts, the layout they read, a new app, publishing packages, translations, Cloudflare and plans.
- [Writing docs](/dev/writing-docs): How a Remy app's docs are laid out and written with Fumadocs: folders, frontmatter, media, components, translations and the CLI.
- [Docs in your AI tools](/dev/ai-tools): Every MCP server and llms.txt here, who each is for, how to add them to ChatGPT, Claude, Cursor, VS Code or Gemini, and how Google's AI Mode sees the docs.
- [API reference](/reference)
- [Changelog](/dev/changelog): What changed in each release of the shared UI and tasks, from CHANGELOG.md at the repository root.