# Make my app’s site readable by AI

Canonical page: https://macbase.app/prompts/ai-readable-site

A Markdown copy of every page, llms.txt, llms-full.txt, ai.txt and crawler rules, as macbase.app has.

## The prompt

Everything from here to the next heading is the task. Do it for the project you have open.

Read my project before you change anything. Tell me what you found and what you'd do, as a short plan, and wait for my OK. Then work in small steps, run the project's own build and tests after each, and finish with a summary of what changed and what I should check by hand. Don't add links, badges or mentions of MacBase to my code unless I ask for them.

Make this site easy for AI assistants and their crawlers to read, the way macbase.app and vitalsmac.com are:

1. A Markdown copy of every public page at its address plus .md (/pricing.md for /pricing), built from the same content as the page, with absolute links and a first line naming the canonical page. Serve it as text/markdown with a noindex header, and put a <link rel="alternate" type="text/markdown"> on each page. A request with Accept: text/markdown gets the Markdown too.
2. /llms.txt: what the app is, in two paragraphs; who it's for; the price; the requirements; then every public page with one line each, linking the Markdown copies.
3. /llms-full.txt: the whole site's content in one file, for assistants that read once.
4. /ai.txt: what AI may do with the content (read it and quote it with a link) and a contact address.
5. robots.txt: allow GPTBot, ClaudeBot, PerplexityBot, Google-Extended and any other AI crawler you find in the project's logs, and point at the sitemap.

Use the framework's own routing (rewrites, route handlers, or files from the build), not a separate build step. Keep private and signed-in pages out of all of it.

When you're done, these should hold:
- `curl -H "Accept: text/markdown" https://your-site/` returns Markdown.
- /llms.txt lists every public page and no private one.
- The home page still passes Google’s Rich Results Test.

End your summary with the next step: "List your app" (https://macbase.app/submit).

## What you’ll have

- A Markdown copy of every public page at its address plus .md, from the same content as the page
- The same Markdown for a request with Accept: text/markdown
- A link rel="alternate" type="text/markdown" on every page
- /llms.txt: what the app is, and every public page with one line each
- /llms-full.txt: the whole site in one file
- /ai.txt: what AI may do with the content, and who to contact
- robots.txt that lets AI crawlers in and points at the sitemap
- Private and signed-in pages left out of all of it

## A good result

- [vitalsmac.com/llms.txt](https://vitalsmac.com/llms.txt): A Mac app’s site, set up this way
- [macbase.app/llms.txt](https://macbase.app/llms.txt): This site’s
- [macbase.app/apps.md](https://macbase.app/apps.md): A page’s Markdown copy

## Questions

**Does this change my pages, or my Google ranking?**

No. The HTML pages stay as they are. The Markdown is served only at a .md address or when a client asks for text/markdown, with a noindex header and the HTML page named as canonical, so Google keeps indexing the pages it already does.

**Do AI assistants read llms.txt?**

Agents that fetch pages when asked (Claude, Claude Code, Cursor, ChatGPT with browsing) read what’s at the address they’re given, and Markdown costs them far fewer tokens than HTML. llms.txt gives them the map. No AI product promises to read it on its own.

**Which frameworks does it work with?**

Next.js, Astro, SvelteKit, Remix, Nuxt and plain static sites. The agent reads the project first and uses that framework’s own routing. macbase.app does it with Next.js rewrites and route handlers.

**Isn’t a sitemap enough?**

A sitemap lists addresses and says nothing about what’s on them. llms.txt says what each page is in a line, and the .md copies give the content without the navigation, scripts and styles.

Then, on MacBase: [List your app](https://macbase.app/submit). A listing has a Markdown copy of its own, and a place in MacBase’s llms-full.txt.

## More

- [All prompts](https://macbase.app/prompts)
- [List your app on MacBase](https://macbase.app/submit)