938143f3f5
The Phoenix auth/identity/tenancy backend repo is being renamed arcadia-app → arcadia-core (its primary OTP app is already arcadia_core). Updates prose, doc paths, and git.sky-ai.com repo URLs. Deliberately leaves the Rust crate arcadia-app-client and host arcadia-app.internal (handled separately), and the kept namespace (issuer/release "arcadia"). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
88 lines
4.3 KiB
Markdown
88 lines
4.3 KiB
Markdown
# Arcadia Admin
|
|
|
|
Admin webapp for [arcadia-core](../reference/arcadia-core) — the multi-tenant Phoenix backend. Built on the [Crema design system](https://git.sky-ai.com/CremaUIStudio) with the **Skyrise** theme and started from the [Vibespace](../vibespace) starter.
|
|
|
|
Surfaces tenant management, user/role administration, billing, audit logs, storage configs, scheduled tasks, feature flags, and platform monitoring on top of arcadia's `/api/v1` and `/admin/*` endpoints.
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
Open [http://localhost:5173](http://localhost:5173). The app talks to arcadia at `http://localhost:4000` by default; override with `VITE_ARCADIA_URL` in `.env.local`.
|
|
|
|
To use it for real:
|
|
|
|
1. Have arcadia running locally (see `../reference/arcadia-core/DEV_SETUP.md`).
|
|
2. Visit `/login` and sign in with admin credentials. In dev seeds: `admin@example.com` / `AdminP@ssw0rd` (tenant `default`).
|
|
|
|
## Configuration
|
|
|
|
| Env var | Default | Purpose |
|
|
|---|---|---|
|
|
| `VITE_ARCADIA_URL` | `http://localhost:4000` | Base URL of arcadia-core. |
|
|
| `VITE_ARCADIA_TENANT` | `default` | Tenant id sent as `X-Tenant-ID`. Override per-deployment. |
|
|
| `VITE_ARCADIA_SEARCH_URL` | `http://127.0.0.1:7800` | Base URL of arcadia-search (Tantivy). |
|
|
| `VITE_ARCADIA_SEARCH_TOKEN` | _(unset)_ | Service-principal JWT for the assistant's `search_kb`/`read_chunk` tools. Set this when arcadia-search runs in `AUTH_MODE=jwt` and doesn't share its signing secret with the arcadia issuing operator session tokens. When unset, the operator's own session JWT is used (works only with matched signing keys). |
|
|
|
|
## What's in here
|
|
|
|
### App shell
|
|
`app/components/layout/app-shell.tsx` — left rail + appbar + avatar dropdown. Brand identity in `app/lib/identity.ts` (`name: "Arcadia Admin"`, icon: `Shield`). The shell is **template code, not a lib** — fork it freely as admin features are added.
|
|
|
|
### Arcadia client + auth UI
|
|
- [`@crema/arcadia-core-client`](../lib-arcadia-core-client) — typed HTTP client (generic + openapi-fetch-backed `client.typed`), Phoenix Channels realtime, error normalization. Mounted at the root via `<ArcadiaProvider>`.
|
|
- [`@crema/arcadia-auth-ui`](../lib-arcadia-auth-ui) — login / signup / password reset / 2FA forms, themed via Skyrise tokens. The `/login` route renders `<LoginForm>`.
|
|
|
|
### Skyrise theme
|
|
[`lib-theme-skyrise`](../lib-theme-skyrise) — premium AI-first glass: iridescent body, frosted-glass surfaces, vivid text, Apple-spring motion. Default 18px root.
|
|
|
|
Surface tints (`body[data-surface="snow|stone|sage|slate"]`) and dark mode (`html.dark`) work out of the box via the existing pickers in the appbar.
|
|
|
|
### Command bus
|
|
[`@crema/action-bus`](../lib-action-bus) — every interactive element has `data-action="<id>"` so admin flows can be scripted, e2e-tested, or driven by an LLM through a single bus. See `docs/AI_FIRST.md`.
|
|
|
|
## Sibling repos
|
|
|
|
```
|
|
your-workspace/
|
|
arcadia-admin/ ← this repo
|
|
vibespace/ ← starter that this was cloned from
|
|
reference/arcadia-core/ ← Phoenix backend (read-only reference)
|
|
lib-arcadia-core-client/
|
|
lib-arcadia-auth-ui/
|
|
lib-action-bus/
|
|
lib-aifirst-ui/
|
|
lib-chat-ui/
|
|
lib-llm-ui/
|
|
lib-notification-ui/
|
|
lib-theme-skyrise/
|
|
```
|
|
|
|
## Dev scripts
|
|
|
|
| Command | What it does |
|
|
|---|---|
|
|
| `npm run dev` | Vite dev server |
|
|
| `npm run build` | Production build |
|
|
| `npm run start` | Serve the built app |
|
|
| `npm run typecheck` | `react-router typegen && tsc` |
|
|
| `npm run test` | Vitest run |
|
|
| `bash start.sh` / `bash stop.sh` | Run dev server in the background |
|
|
|
|
## Conventions
|
|
|
|
- **Brand strings, not literals.** Use `useBrand().name` — never hardcode "Arcadia Admin".
|
|
- **`[data-action="<id>"]`** on every interactive element. Naming: `nav-*`, `appbar-*`, `tenants-*`, `users-*`, `audit-*`, etc.
|
|
- **Tokens, not values.** `bg-card`, `text-foreground`, `var(--primary)` — never hex.
|
|
- **Lib edits commit to each lib's own repo.** `git status` here only shows app-level changes.
|
|
|
|
## Further reading
|
|
|
|
- [`docs/AI_FIRST.md`](docs/AI_FIRST.md) — command-bus / DSL system tour
|
|
- [`app/components/layout/THEME_CONTRACT.md`](app/components/layout/THEME_CONTRACT.md) — token contract every theme must satisfy
|
|
- `CLAUDE.md` — orientation for an LLM working in this repo
|
|
- `../reference/arcadia-core/` — backend (DEV_SETUP, controllers, OpenAPI source-of-truth)
|