---
title: "Adonia"
description: "The admin panel framework for AdonisJS v7 — panels, resources, one schema tree."
image: "https://adonia.pages.dev/og.png"
version: "next"
---

> Documentation Index
> Fetch the complete documentation index at: https://adonia.pages.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Adonia

## One schema, one trusted path

A resource definition becomes the index, create, edit, and detail projections, the VineJS
validator, and the safe persistence allowlist. Adonia keeps those contracts together instead
of asking the browser to reproduce server decisions.

The same runtime includes tables, relations, actions, dashboards, global search, tenancy,
soft deletes, uploads, authorization, custom fields, plugins, and queue/search adapters.
Everything remains native to AdonisJS, Lucid, VineJS, Bouncer, Ace, and Inertia + React.

## Choose a path

### Build your first panel

1. Read the [requirements and installer contract](/guide/install).
2. Follow [Build a blog admin](/guide/tutorial/) for an end-to-end application.
3. Use [Panels](/guide/panels) and [Resources](/guide/resources) as the daily authoring guides.
4. Keep the generated [Fields reference](/reference/fields/) and [Public API](/reference/api/) nearby.

### Learn the model

Start with the [Introduction](/guide/introduction). It explains the resource abstraction,
the one-tree/many-projections model, the server/client descriptor boundary, and why omitted
fields disappear from rendering, validation, and persistence together.

Then go deeper:

| Topic | Documentation |
| --- | --- |
| Layout and fields | [Schema and layout](/schema-components), [fields](/reference/fields/), [custom fields](/guide/custom-fields) |
| Tables and querying | [Tables and columns](/table-columns), [filters and search](/guide/filters-and-search), [query pipeline](/query-pipeline) |
| Forms and writes | [Validation](/guide/validation), [form engine](/form-engine), [error model](/error-model) |
| Access control | [Authorization](/authorization), [tenancy](/guide/tenancy), [nested resources](/guide/nested-resources) |
| Presentation | [Theming](/theming), [i18n and accessibility](/guide/i18n-accessibility), [accessibility contract](/accessibility) |
| Extensions | [Plugin authoring](/guide/plugin-authoring), [reference plugins](/guide/reference-plugins) |

### Operate in production

Use the [deployment and security checklist](/guide/deployment-security), then review
[observability](/observability), [performance](/guide/performance), the [bundle budget](/bundle-budget),
[CI gates](/ci), and the [upgrade policy](/guide/upgrade-policy). Run
[`adonia:doctor`](/doctor) after installation and upgrades.

### Understand or extend the internals

The [descriptor protocol v1](/protocol/v1) defines the frozen wire format and its
additive extension rules. Contributors should begin with the
[contribution guide](/guide/contributing).

## The shortest working path

In an AdonisJS 7 application with Lucid and Inertia + React:

```sh
node ace add @adonia/core
node ace migration:run
node ace adonia:resource Post
node ace serve --hmr
```

The installer publishes the default panel and generic Inertia pages, registers the provider
and codegen hook, wires styles and middleware seams, and creates action persistence
migrations. Visit `/admin` after the server starts.

## Packages

| Package | Responsibility |
| --- | --- |
| `@adonia/core` | Server runtime, resource DSL, query and validation pipelines, protocol, provider |
| `@adonia/ui` | React pages, renderer, component registry, hooks, theme, styles |
| `@adonia/devtools` | Installer, Ace commands, generators, codegen, doctor checks |
| `@adonia/queue-bullmq` | BullMQ queued-action adapter |
| `@adonia/meilisearch` | Meilisearch driver adapter |
| `adonia-activity-log` | Authorization-safe activity log reference plugin |
| `adonia-import-export` | Streaming import and queued export reference plugin |

The complete tutorial application is maintained in `examples/blog-admin`; reusable starter
content is in `templates/adonia-starter`.

Source: https://adonia.pages.dev/index.mdx