# Docs


- **Start**
- [Getting started](/docs): Connect your AI, ask for an app, watch it appear in a live preview, and publish it on a paid plan.
- [How projects work](/docs/how-projects-work): What a LazyFrog project is: the preview where your AI builds, the live site your visitors see, why a quiet preview sleeps and wakes, and what is kept.
- [Connect your AI and keep its tools current](/docs/connect): Connect LazyFrog once in Claude, ChatGPT or Codex. When LazyFrog adds tools, here is how each app picks them up.
- [Connect Claude](/docs/connect-claude): Add LazyFrog as a connector in Claude once, and it works on the web and on your phone. Claude Desktop and Claude Code have their own short steps.
- [Connect ChatGPT](/docs/connect-chatgpt): Add LazyFrog to ChatGPT with one address and one sign-in, so ChatGPT can build, preview and publish your app with its own database.
- [Connect Codex](/docs/connect-codex): Add LazyFrog to OpenAI's Codex on the command line with two commands and one sign-in, then ask Codex to build, preview and publish your app.

- **Building**
- [Publishing and rollback](/docs/publishing): How publishing your site works on LazyFrog: a test run first, no downtime for your visitors, and how to go back to the version before.
- [Your own domain](/docs/domains): Connect a domain you own to your live site, with HTTPS ready before it switches.
- [Snapshots and undo](/docs/snapshots): Undo on LazyFrog: automatic snapshots of your project, one before anything risky, and restoring the code, the database, the files or all of it.
- [Databases](/docs/databases): Every LazyFrog project has its own PostgreSQL 19 database: one for the preview your AI builds in, and one for your live site.
- [Files and uploads](/docs/files): Where your app keeps the files visitors upload, such as photos and documents: a store that survives publishes, public links, and an S3-compatible API for developers.
- [Forms](/docs/forms): Contact and sign-up forms with no backend code, with submissions stored in your database.
- [Email from your app](/docs/email): Sign-in links, receipts and booking confirmations, sent from your own domain through your own email provider, on paid plans.
- [AI inside your app](/docs/ai-in-your-app): Chatbots and summaries in your app, with your provider key kept out of the app and a monthly spending cap.
- [Secrets](/docs/secrets): API keys and passwords for your app, separate for preview and live, never shown back and never in the chat.
- [Redirects, headers and protection](/docs/routing): Redirects, rewrites, security headers, CORS, password-protected pages and IP or country limits, without app code.
- [Services](/docs/services): What runs in your project (a website, an API, background workers, scheduled jobs, static files) and how it is set up in services.json.

- **Your code**
- [Git and your code](/docs/git): Your code is always yours: every project is a git repository you can clone, connect to GitHub or any git host, and run anywhere.
- [Moving in and moving out](/docs/import-export): Import an app from Lovable, Bolt, v0, Replit, Vercel or any repository, and export everything whenever you like.
- [Working with other people](/docs/working-together): Invite people to a project with their own AI, or hand a project over to someone else's account.
- [Sharing, remixing and the showcase](/docs/sharing): Let others copy your project, put it in the showcase, share a link that looks good when posted, and invite friends.

- **Plans and trust**
- [Plans and limits](/docs/plans-and-limits): Exactly what each LazyFrog plan includes (Free, Hobby, Pro and Business), and what happens when you get near a limit.
- [Your account](/docs/your-account): Managing your LazyFrog account: the Trash for deleted projects, deleting your account, the emails we send you, and where your site's images come from.
- [Security](/docs/security): How LazyFrog keeps your apps and data safe: each project isolated, encryption, backups, secrets kept out of your code, security scans and tamper alerts.
- [FAQ](/docs/faq): Short answers about LazyFrog: do you need to code, the free plan, your own domain, what happens if your AI breaks something, refunds, leaving, and where data is kept.

- **Reference**
- The guide your AI reads
  - [The guide your AI reads](/docs/guide): Exactly what LazyFrog tells your AI when it starts working: how to build, preview and publish here, and its limits. Word for word, from the platform itself.
  - [Reading and changing: use the read-only tools to read](/docs/guide/reading-and-changing-use-the-read-only-tools-to-read): How your AI uses LazyFrog's read-only tools to look at your project, so looking never needs your approval and only real changes do.
  - [Two jobs: building in the preview, helping run the business on the live site](/docs/guide/two-jobs-building-in-the-preview-helping-run-the-business-on-the-live-site): Your AI's two jobs on LazyFrog: building in the preview, and helping you run your business on the live site without putting it at risk.
  - [Before you build something new](/docs/guide/before-you-build-something-new): What your AI does before it builds something new on LazyFrog: a short plan, the questions only you can answer, and waiting for your yes.
  - [Start here](/docs/guide/start-here): How your AI starts a LazyFrog project: a template (Next.js, Python FastAPI, static, blank) or any other stack, and the first steps to a working preview.
  - [WordPress](/docs/guide/wordpress): How your AI sets up WordPress on LazyFrog, step by step in the right order, so your site keeps the correct address and its database works from day one.
  - [Where files live](/docs/guide/where-files-live): Where a LazyFrog project's files live: the code, uploaded files and imported photos, and what is published to your live site.
  - [Services (`services.json`)](/docs/guide/services-services-json): How your app's services are set up in services.json on LazyFrog: web servers, APIs, background workers, scheduled jobs and static sites.
  - [Database](/docs/guide/database): How your AI works with your project's own PostgreSQL database on LazyFrog: migrations, preview and live data, and keeping live data safe.
  - [Files and uploads](/docs/guide/files-and-uploads): Where an app on LazyFrog keeps uploaded and generated files: a file store that survives publishes, public file links and an S3-compatible API.
  - [Forms](/docs/guide/forms): How a contact or sign-up form works on LazyFrog with no backend code: submissions saved in your database, spam filtering and email notifications.
  - [Routing (`routing.json`)](/docs/guide/routing-routing-json): How your AI sets up redirects, rewrites, headers, CORS, password-protected pages and custom error pages in routing.json, with no app code.
  - [Git](/docs/guide/git): How git works in a LazyFrog project: commits, connecting a repository such as GitHub, and keeping your code where you want it.
  - [Working from a checkout](/docs/guide/working-from-a-checkout): How to work on a LazyFrog project from your own computer with Claude Code: clone it, change it locally, and git push to update the preview.
  - [Working with other people](/docs/guide/working-with-other-people): How several people work on one LazyFrog project: on Pro and Business, up to 3 people per project, each with their own AI, building and publishing together.
  - [Redesigning or moving an existing website](/docs/guide/redesigning-or-moving-an-existing-website): How your AI moves or redesigns an existing website on LazyFrog: capture the old site, rebuild it, and compare page by page before publishing.
  - [A site with several pages](/docs/guide/a-site-with-several-pages): How your AI builds a site with several pages on LazyFrog: the header, menu, footer and look each come from one place, so no page drifts.
  - [Changing an existing site](/docs/guide/changing-an-existing-site): How your AI changes a site that is already live: small checked steps in the preview, screenshots before and after, and publishing only when you ask.
  - [Account matters (the user does these in the portal)](/docs/guide/account-matters-the-user-does-these-in-the-portal): What only you do in your LazyFrog account, never your AI: your password and sign-ins, plans and billing, exporting your data and deleting your account.
  - [Keeping a project current](/docs/guide/keeping-a-project-current): How your AI keeps a LazyFrog project safe and up to date: security scans, dependencies with known vulnerabilities and the versions that fix them.
  - [Their own photos and files](/docs/guide/their-own-photos-and-files): How you give your AI your own photos and files for your site: attach them in the chat, add them on the project card, or use an upload link.
  - [Bringing an app here, and taking it away](/docs/guide/bringing-an-app-here-and-taking-it-away): How to bring an app to LazyFrog (a git repository, a chat prototype or a live website) and how to take it with you if you leave.
  - [Make it real: from a chat prototype to a project](/docs/guide/make-it-real-from-a-chat-prototype-to-a-project): How to turn a prototype your AI made in the chat into a real LazyFrog project, with a database, a preview to share and a public address.
  - [Secrets](/docs/guide/secrets): How API keys and other secrets work on LazyFrog: pasted in your LazyFrog account rather than the chat, set per environment, and never shown back.
  - [Seeing your work](/docs/guide/seeing-your-work): How your AI checks its work on LazyFrog: screenshots, trying pages in a real browser, design checks and reading what your app returns.
  - [Publishing](/docs/guide/publishing): How publishing works on LazyFrog: a test run first, no downtime, your live address, scheduled publishes, and going back if something breaks.
  - [Taking payments (the user's own shop)](/docs/guide/taking-payments-the-user-s-own-shop): How to take payments in an app on LazyFrog with your own Stripe account: customers pay you directly and LazyFrog never touches the money.
  - [Email, AI and PDFs for the app](/docs/guide/email-ai-and-pdfs-for-the-app): How an app on LazyFrog sends email through your own provider, uses AI features through the AI gateway, and makes PDFs.
  - [Custom domains](/docs/guide/custom-domains): How to connect your own domain to your site on LazyFrog: buy it anywhere, add the DNS records, and the certificate follows.
  - [Safety nets](/docs/guide/safety-nets): LazyFrog's safety nets: automatic snapshots, undoing the last change, restoring code or data, and off-site backups on paid plans.
  - [When something fails](/docs/guide/when-something-fails): What your AI does when a build, a command or a publish fails on LazyFrog: read the error, find the cause, and fix it at the source.
  - [When the live site breaks](/docs/guide/when-the-live-site-breaks): What your AI does when the live site breaks but the preview works: check the live services, logs, files and data in order to find what really changed.
  - [Being told when things happen](/docs/guide/being-told-when-things-happen): How your AI tells you when something happens on LazyFrog: a new form submission or order, a failed publish, the site going down, a domain working.
  - [Sign-in for the app's users](/docs/guide/sign-in-for-the-app-s-users): How to add sign-in to an app on LazyFrog, from a password-protected admin page with no code to accounts for your app's own users.
  - [Building good apps here](/docs/guide/building-good-apps-here): Recipes for particular kinds of app on LazyFrog, such as offline, installable phone apps (PWA) and API products.
- Tool reference
  - [Tool reference](/docs/tools): Every tool LazyFrog gives your AI, what each one does and whether it can change anything, as your AI sees them. From the platform itself.
  - [account](/docs/tools/account): Shows your AI which LazyFrog account it is signed in to: your plan, whether your email is confirmed, and where you change plan. It changes nothing.
  - [ai](/docs/tools/ai): Lets the app you build use AI (OpenAI, Anthropic and others) through LazyFrog's AI gateway, with the provider key kept out of your code and a monthly cap.
  - [ai_read](/docs/tools/ai_read): Shows which AI providers the app you build can use through LazyFrog's AI gateway, and its monthly spending cap. It changes nothing.
  - [card_projects](/docs/tools/card_projects): Shows your LazyFrog projects as a card inside the chat, with each one's status and addresses at a glance. It changes nothing.
  - [db](/docs/tools/db): Changes your app's PostgreSQL database: migrations, tables and data. A destructive change to your live site's data waits for your approval in your LazyFrog account.
  - [db_query](/docs/tools/db_query): Runs SQL on your app's PostgreSQL database, in the preview or on your live site's data. Reading live data runs read-only, with a time limit, and is marked as live.
  - [db_read](/docs/tools/db_read): Runs read-only queries on your app's PostgreSQL database, in the preview or on your live site's real data (orders, customers, bookings). It changes nothing.
  - [db_schema](/docs/tools/db_schema): Shows your database's tables, columns, foreign keys, checks and views, so your AI knows the shape of your data before changing code. It changes nothing.
  - [deploy](/docs/tools/deploy): Publishes your preview to your live site with no downtime: a test run first, then the publish, or one scheduled for a set time. Your AI publishes only when you ask.
  - [deploy_list](/docs/tools/deploy_list): Lists your site's publishes, newest first: which one is live, what each changed, why a failed one failed, and which you can roll back to. It changes nothing.
  - [design_check](/docs/tools/design_check): Checks a page the way visitors see it on a phone, a tablet and a laptop, and lists what's wrong with plain fixes: blank pages, sideways scrolling, hard-to-read text.
  - [domain](/docs/tools/domain): Connects your own domain to your live site: the DNS records to add where you bought it, then the certificate. Hobby: 1 domain per project, Pro 5, Business 10.
  - [domain_list](/docs/tools/domain_list): Lists the domains connected to your site: each one's state, whether it is the main address or a redirect, and any DNS records still needed. It changes nothing.
  - [domain_read](/docs/tools/domain_read): Checks whether a domain name is free before you buy it, and whether a connected domain's DNS records are right. LazyFrog doesn't sell domains. It changes nothing.
  - [email](/docs/tools/email): Lets your app send email (confirmations, receipts, notifications) through your own provider, such as Postmark, Brevo, Resend or any SMTP server. Paid plans.
  - [email_read](/docs/tools/email_read): Shows whether your app's email is set up: the connected provider, the sender, recent sends and any errors from the provider. It changes nothing.
  - [exec](/docs/tools/exec): Runs a shell command in your preview: installs, builds, tests, scripts and git, with your database address and preview secrets already set.
  - [feedback](/docs/tools/feedback): Lets your AI tell LazyFrog when the platform got in its way: a missing feature, a misleading error or a bug. LazyFrog reads every report.
  - [forms](/docs/tools/forms): Manages what your site's forms collect: who is told about a new submission, marking spam and deleting entries. Forms need no backend code on LazyFrog.
  - [forms_read](/docs/tools/forms_read): Shows what visitors sent through your site's forms (contact messages, sign-ups, orders), newest first, with spam marked. It changes nothing.
  - [fs_diff](/docs/tools/fs_diff): Compares a file or folder in your preview with your live site, to find what the live site really runs when it misbehaves and the preview doesn't. It changes nothing.
  - [fs_edit](/docs/tools/fs_edit): Changes part of a file in your preview by replacing exact text, so a small fix stays small. Every change is recorded and can be undone.
  - [fs_import](/docs/tools/fs_import): Saves files you attached in the chat (photos, PDFs, spreadsheets) into your project, so your AI can use them on your site.
  - [fs_list](/docs/tools/fs_list): Lists the files and folders in your preview: the code, uploaded files and data. It changes nothing.
  - [fs_read](/docs/tools/fs_read): Reads a file from your preview, in full or a range of lines, so your AI sees the code before changing it. It changes nothing.
  - [fs_search](/docs/tools/fs_search): Searches the files in your preview for text or a pattern and shows the matching lines. It changes nothing.
  - [fs_write](/docs/tools/fs_write): Writes whole files into your preview: new pages, components and images. Every change is recorded and can be undone.
  - [git](/docs/tools/git): Commits your preview's work, connects a repository such as GitHub, and pushes or pulls, so your code also lives where you keep it.
  - [git_read](/docs/tools/git_read): Shows your project's git history: recent commits, uncommitted changes and the connected repository. It changes nothing.
  - [guide](/docs/tools/guide): LazyFrog's guide for your AI: how projects, previews, databases and publishing work here. Your AI reads it at the start of a session. It changes nothing.
  - [http_get](/docs/tools/http_get): Fetches a page or API answer from your running app, so your AI checks what it really returns before saying something works. It changes nothing.
  - [http_request](/docs/tools/http_request): Sends a POST, PUT, PATCH or DELETE request to your own running app, such as a form post or a sign-in, to test what it does.
  - [images](/docs/tools/images): Puts your own photos and licensed Unsplash stock photos where they belong on your site, crops and optimises them for the web, and shows them to your AI.
  - [images_read](/docs/tools/images_read): Shows the images in your project and searches licensed Unsplash stock photos. It saves nothing, costs nothing and changes nothing.
  - [job](/docs/tools/job): Follows long-running work your AI started, such as a build or a publish: its progress and output, or stopping it.
  - [job_read](/docs/tools/job_read): Shows the progress and output of long-running work your AI started, such as a build or a publish. It changes nothing.
  - [logs_tail](/docs/tools/logs_tail): Reads the recent logs of your app, in the preview or on your live site, to find errors and what happened. It changes nothing.
  - [look](/docs/tools/look): Gives your site its own look: your AI proposes 2 to 4 design directions (colours, fonts, spacing, mood), you choose one, and it is applied across the site.
  - [look_read](/docs/tools/look_read): Shows the look chosen for your site: its colours, fonts and design settings. It changes nothing.
  - [message](/docs/tools/message): Lets your AI draft an email to one of your customers. Nothing is sent until you approve the exact recipient and text in your LazyFrog account.
  - [message_read](/docs/tools/message_read): Shows whether a customer email your AI drafted is waiting for your approval, sent or declined. It changes nothing.
  - [payments](/docs/tools/payments): Connects your own Stripe account to your app so customers pay you directly. LazyFrog never takes the payment, and your key never passes through the chat.
  - [payments_read](/docs/tools/payments_read): Checks your app's Stripe connection: a test or live key, whether the account can take payments, and its webhook. It changes nothing.
  - [plan](/docs/tools/plan): Keeps your project's plan: the brief and roadmap you agree with your AI and approve, so later sessions and other AIs start from it.
  - [plan_read](/docs/tools/plan_read): Shows your project's plan: the agreed brief, its milestones and progress. It changes nothing.
  - [preview_screenshot](/docs/tools/preview_screenshot): Takes a screenshot of your preview at any width and compares it with the one before a change: the proof a page looks right. It changes nothing.
  - [preview_try](/docs/tools/preview_try): Clicks, types and uploads on your preview in a clean browser and reports what happened, so a form, menu or player is really tried, not just looked at.
  - [project](/docs/tools/project): Creates and manages your LazyFrog projects: a new app from a template, its settings and preview address, or deleting it, which waits for your approval.
  - [project_read](/docs/tools/project_read): Lists your LazyFrog projects and shows one: its status, template, and preview and live addresses. It changes nothing.
  - [project_scan](/docs/tools/project_scan): Scans your project for the mistakes AI-written apps make: SQL built from strings, secrets in code, routes without an auth check, dependencies with known flaws.
  - [routing](/docs/tools/routing): Sets your site's redirects, rewrites, headers, CORS, password-protected pages and custom error pages, with no app code.
  - [routing_read](/docs/tools/routing_read): Shows your site's routing rules and checks what a visitor gets at a path, such as a redirect or a password prompt. It changes nothing.
  - [secrets](/docs/tools/secrets): Manages your project's secrets, such as API keys: you paste the values in your LazyFrog account, so they never pass through the chat.
  - [secrets_read](/docs/tools/secrets_read): Lists the names of your project's secrets, such as API keys. The values are never shown, and it changes nothing.
  - [service](/docs/tools/service): Defines and runs your app's services (web servers, APIs, background workers, scheduled jobs and static sites), and restarts or stops them.
  - [service_status](/docs/tools/service_status): Shows whether your app's services and database are running, crashed or restarting, with their health checks. It changes nothing.
  - [site](/docs/tools/site): Brings an existing website into your project: LazyFrog captures its public pages, then compares your rebuild with the original, page by page.
  - [site_read](/docs/tools/site_read): Shows what was captured from an existing website and how closely your rebuild matches each original page. It changes nothing.
  - [snapshot](/docs/tools/snapshot): Takes and restores snapshots of your project's code, database and files, and undoes the last change in one step. A restore can itself be undone.
  - [snapshot_list](/docs/tools/snapshot_list): Lists your project's snapshots: hourly automatic ones, ones you asked for, and those taken before risky changes. It changes nothing.
  - [support](/docs/tools/support): Contacts the LazyFrog team about a problem with the platform, and only when you ask your AI to.
  - [support_read](/docs/tools/support_read): Shows your support requests to the LazyFrog team, with their replies and status. It changes nothing.
  - [usage_get](/docs/tools/usage_get): Shows your plan, its limits and this month's usage (projects, CPU, memory, disk and bandwidth), with a warning well before a limit. It changes nothing.