ARDOR Guides

ARDOR is the browser framework of VENIZIA. It structures ra-core applications inside an IGNIS inversion-of-control container. These guides take you from a first project to the core concepts and a migration path.

ARDOR gives you:

A container and decorators in the browser (@venizia/ardor-kernel), with React hooks to resolve what you bind (@venizia/ardor-react). @venizia/ardor re-exports the kernel, react and admin packages.
A REST data provider, token refresh on a 401 and i18n for ra-core (@venizia/ardor-admin).
An HTTP repository from IGNIS on @venizia/ardor/repository, which can share the data provider's token and 401 refresh through getDataSourceAuth().
Runtime configuration. RuntimeConfig.get reads window.__APP_CONFIG__, so one built image serves every environment; with required: true it throws an error that carries a code. See One image for every environment.
A VULCAN preset that generates an admin with Tailwind, an nginx image (gzip, /health, security headers) and that runtime configuration.

ARDOR is before 1.0, and a minor release can break: read where ARDOR is today.

Where to start

Create a Project

Start a monorepo with an admin, or add one to a monorepo you have, with one VULCAN command

Setup

Install Bun, configure dependencies, and prepare your development environment

Quickstart

Write a small admin by hand against a stub API: a datasource, a repository, a list page and a login

Vite setup

What an app needs in its Vite 8 config: the chunk order flag the preset sets, and buildInfoFile for an About page

Build an Admin

Create a complete administration console with list, create, edit and delete pages for one resource

Add Sign-In

Configure sign-in, roles, token refresh and sign-out

Add a Language

Set up polyglot dictionaries, locale switching, and translated message bundles

Application

Understand BaseArdorApplication container lifecycles and the root component

Configuration

Declare provider options and container singletons with configuration classes

Providers

Wire data, auth, i18n, network, permission, and features

Resources and Pages

Define list, create and edit pages, custom routes and the CoreAdmin props

Dependency Injection

Resolve services and repositories across React components and container scopes

Philosophy

Architectural principles and design decisions behind ARDOR and IGNIS

Upgrading ARDOR

Which changelog entry to read for your version, and the codemod that moves the removed names

Migration

Migrate legacy administration interfaces from @minimaltech/ra-core-infra

Learning Roadmap

First Steps

Create a Project or Setup → Quickstart

Generate an admin with one command, or set up a Vite project and write a small one by hand

Build Something Real

Build an Admin → Add Sign-In → Add a Language

Construct complete administrative interfaces with authentication and translations

Understand the Framework

Application → Configuration → Providers → Resources and Pages → Dependency Injection

Deep dive into container lifecycles, configuration classes, and dependency resolution

Go Further

API References → Best Practices → Migration

Consult technical references, apply production patterns, and migrate legacy codebases