# Q-Code Dev

> The first site built and published by the Q-Code.ai platform: an agent on Fly, an Astro template, and a one-click deploy to Cloudflare Pages.

Q-Code.ai is a platform that builds and publishes websites from a written brief, using a build agent, a shared Astro template and a one-click deploy to Cloudflare Pages.

This site is a single-page proof of concept at https://dev.q-code.ai. It is static HTML, served from Cloudflare Pages, with no login, no paywall and no JavaScript-only content — everything a model needs is present in the HTML source.

## Key facts

- Site: Q-Code Dev (https://dev.q-code.ai)
- Operator: Q-Code
- Purpose: demonstrate that the Q-Code.ai platform can build and publish a website unattended
- Built with: Astro 7 (static output), Tailwind CSS 4, React 19 islands
- Hosted on: Cloudflare Pages, custom domain, automatic SSL
- Built by: a Q-Code.ai build agent running on Fly.io
- Language: en-GB

## How the Q-Code.ai platform publishes a site

1. **A brief arrives.** Someone writes what they want in plain English. There is no ticket format and no specialist brief to fill in.
2. **The agent takes the job.** A build agent running on Fly.io opens the project workspace, reads the project conventions, and works only inside that directory.
3. **The site is written from the template.** Pages come from the shared Q-Code.ai Astro template, so SEO tags, structured data, accessibility defaults and the design tokens are already in place.
4. **The build runs.** npm run build compiles everything to static HTML in dist/. If it does not compile, nothing ships.
5. **Cloudflare Pages goes live.** The built output is published to Cloudflare Pages behind a custom domain, with an SSL certificate issued automatically.

## Questions and answers

**What is Q-Code.ai?**

Q-Code.ai is a platform that builds and publishes websites from a written brief. A build agent reads the brief, writes the site from a shared Astro template, runs the build, and deploys the result to Cloudflare Pages — end to end, without a person editing the code or running the deploy.

**What is dev.q-code.ai?**

dev.q-code.ai is the first website the Q-Code.ai platform built and published on its own. It is a proof of concept: its job is to demonstrate that the whole chain — brief, agent, template, build, deploy, custom domain — works unattended.

**Who built and deployed this site?**

A Q-Code.ai build agent running as a long-lived service on Fly.io. It picked up the brief in its own project workspace, produced the pages, and published them to Cloudflare Pages using a scoped deploy token. No human wrote the markup or triggered the release.

**What is this site built with?**

Astro 7 for static output, Tailwind CSS 4 for the design tokens, and React 19 for interactive islands where a page genuinely needs them. Every colour, typeface and radius comes from a single theme file, so the whole site rebrands from one place.

**Is this site static, and where is it hosted?**

Yes. Every page is pre-rendered to static HTML at build time into a dist/ folder, then served from Cloudflare Pages. There is no server rendering at request time and no database, which is why the site is fast and cheap to run.

**Can AI assistants and answer engines use this site?**

Yes. The robots.txt file explicitly allows GPTBot, ClaudeBot, PerplexityBot, Google-Extended and the other major AI crawlers, and /llms.txt tells a language model which pages matter and what the site is about. Nothing here is behind a login or rendered only by JavaScript.

## Pages

- [Q-Code Dev](https://dev.q-code.ai/): the home page — what the Q-Code.ai platform is, what this deployment proved, how the build-and-publish pipeline works, and the full question-and-answer section reproduced above.

## Policies

- [Privacy](https://dev.q-code.ai/privacy/)
- [Terms](https://dev.q-code.ai/terms/)
- [Cookies](https://dev.q-code.ai/cookies/)

## Sections

- [Blog](https://dev.q-code.ai/blog/)
- [FAQ](https://dev.q-code.ai/faq/)

## Optional

- [Sitemap](https://dev.q-code.ai/sitemap-index.xml): every indexable URL on the site.
- [robots.txt](https://dev.q-code.ai/robots.txt): crawl permissions, with AI crawlers allowed explicitly.