✦ Quick start

Deploy Aria to Cloudflare in one click, or run it locally with Node and SQLite.

Deploy to Cloudflare

1. Click the Deploy to Cloudflare button above.
2. Accept the generated resources. Give the two KV namespaces distinct titles (e.g. aria-cache and aria-session) - the automatic deployment cannot prefill those.
3. Open /admin on the live site, create your first administrator, and complete first-launch.

Details, prerequisites, and manual deploy: Cloudflare deployment guide.

Run locally

Requires Node.js >= 22.18.0 and npm.

git clone https://github.com/ariabuilder/aria.git
cd aria
npm install
npm run dev

For Cloudflare bindings locally, use npm run dev:edge.

Open http://localhost:4321/admin and finish setup at /admin.

Optional Cloudflare Analytics

After you attach a Cloudflare-managed custom domain, you can show zone traffic inside Aria. Setup: Cloudflare deployment guide.

Local setup · Edge development

✦ Choose a runtime

The same Astro project, Astro Actions, and StorageAdapter run in both modes.See storage and runtimes for the architecture and trade-offs.

✦ What Aria Builder includes

✦ Why Aria exists

The job has not changed: ship a site, manage content, and iterate on design.Aria Builder combines visual editing with an Astro codebase and a runtime you control.

✦ Ownership and architecture

Aria separates code deployment, schema migrations, and content promotion.A builder update does not overwrite live pages or settings unless you explicitly promote content.

The Studio export creates a clean Astro project you can take elsewhere. For deployment, media storage, content promotion, and environment configuration, use the Cloudflare deployment guide, content-sync guide, and environment-variable reference.

Technical details for contributors, including the generated inline-SVG icon pipeline, are documented in the platform architecture.

✦ Status and roadmap

Aria is pre-launch and under active development.

Webhook automation, third-party OAuth, Figma integration, and plugins are not currently available and are currently being developed.

See ROADMAP.md for publicly planned work.

✦ Documentation

Start with Aria docs for setup, deployment, Studio workflows, and contributor architecture.

Documentation will be expanded on as we progress with development. Expect full step by step guides, video tutorials, and more.

✦ Contributing and support

Contributions are welcome. Read CONTRIBUTING.md, review the contributor documentation, and open an issue before substantial architectural changes. Support expectations are in SUPPORT.md.

Bundled front-end asset notices, including Outfit under the SIL OFL 1.1, are listed in Acknowledgements.

Built for creators.

Apache-2.0 | See LICENSE | Trademarks | Acknowledgements