# Aero

> Build fast, HTML-first static sites and full-stack apps with a native web feel.

## Docs

- [Examples](https://aerojs.mintlify.app/examples/index.md): Sample projects and templates to learn from and copy patterns from.
- [Assets](https://aerojs.mintlify.app/getting-started/assets.md): Manage client scripts, styles, images, and static files in your Aero project.
- [Configuration](https://aerojs.mintlify.app/getting-started/configuration.md): Configure Aero through the Vite plugin or a dedicated aero.config.ts file.
- [Content](https://aerojs.mintlify.app/getting-started/content.md): Define typed content collections, query them at build time, and render Markdown to HTML.
- [Deployment](https://aerojs.mintlify.app/getting-started/deployment.md): Deploy your Aero site to any static host or ship a full-stack Nitro server.
- [Installation](https://aerojs.mintlify.app/getting-started/installation.md): Scaffold your first Aero project and have a site running in minutes.
- [Metadata](https://aerojs.mintlify.app/getting-started/metadata.md): Configure your site URL, manage head tags, and set up SEO basics for your Aero site.
- [Routing](https://aerojs.mintlify.app/getting-started/routing.md): Map HTML files to URLs using Aero's file-based router. Your file path is your URL.
- [Scripts](https://aerojs.mintlify.app/getting-started/scripts.md): Understand Aero's four script types and when to use each one.
- [Server](https://aerojs.mintlify.app/getting-started/server.md): Add API routes, server-side logic, and full-stack capabilities with Nitro.
- [Structure](https://aerojs.mintlify.app/getting-started/structure.md): How a scaffolded Aero project is laid out: client, content, public, optional server, and config files.
- [Styling](https://aerojs.mintlify.app/getting-started/styling.md): Use standard CSS in Aero — linked stylesheets, inline styles, and CSS frameworks all work as expected.
- [Templates](https://aerojs.mintlify.app/getting-started/templates.md): Pages, components, and layouts are all .html templates. Learn the shared syntax and the three roles a template can play.
- [Dependency policy](https://aerojs.mintlify.app/guide/dependency-policy.md): How the Aero monorepo pins shared dependency versions for reproducible builds and intentional upgrades.
- [The HTML template element](https://aerojs.mintlify.app/guide/html-template.md): Wrapperless structural directives, literal inert templates, and attributes on wrapperless template tags.
- [Importing and bundling](https://aerojs.mintlify.app/guide/importing-and-bundling.md): How Vite bundles client scripts and options for htmx, Alpine, CDN loads, externals, and code splitting.
- [Learner's guide: native web vs Aero](https://aerojs.mintlify.app/guide/learners-guide.md): Which parts of an Aero file are plain HTML and which are interpreted by Aero at build time.
- [Philosophy](https://aerojs.mintlify.app/guide/philosophy.md): What makes Aero different from typical frameworks, and how it relates to Web Components.
- [Standalone runtime](https://aerojs.mintlify.app/guide/standalone-runtime.md): Render Aero templates outside a full Vite app using @aero-js/core/runtime/standalone.
- [TypeScript](https://aerojs.mintlify.app/guide/typescript.md): Add type safety to build scripts, component props, content collections, and environment variables.
- [Introduction](https://aerojs.mintlify.app/index.md): Build fast, HTML-first static sites and full-stack apps with a native web feel.
- [CLI](https://aerojs.mintlify.app/tooling/cli.md): Validate templates, check types, and diagnose your project with the Aero CLI.
- [Image Optimization](https://aerojs.mintlify.app/tooling/image-optimization.md): Automatically compress images during your production build with Aero's built-in optimization pipeline.
- [Incremental Builds](https://aerojs.mintlify.app/tooling/incremental-builds.md): Skip or narrow the static HTML prerender phase on repeat builds using Aero's build cache.
- [VS Code Extension](https://aerojs.mintlify.app/tooling/vscode-extension.md): Get syntax highlighting, completions, hover info, and inline diagnostics for Aero templates in VS Code.