The admin panel for SethuCMS. It talks only to the SethuCMS gateway, never to a database directly.
| Page | What it is for |
|---|---|
| Home | One sentence on whether your connections are healthy, what each database can do, what is waiting for review, and recent activity |
| Content | A three-pane studio: pick a connection and collection, search and page through records, edit one in a form built from the collection's fields |
| Drafts and publish | Edits are saved automatically as a draft. Nothing reaches your database until you press Publish. If the record changed meanwhile you are asked before overwriting it |
| Schedule | On a draft, Schedule publishes it at a time you pick (in your time zone). You can change the time or cancel the schedule. It needs a gateway that keeps running, not a serverless one |
| Singletons | A collection marked singleton in the gateway's schema file (site settings, say) opens straight into its one record, with no list, New or Delete |
| Live preview | Opens a signed preview link for the draft and shows it updating as you type. The same link can be used by your own website |
| Connections | Add several databases at once, test them, read their structure again, choose which collections appear in the API, switch between read-only and read-write |
| Roles and access | Create and revoke API tokens (admin, editor, viewer) |
| Audit log | Who changed what, and when. Passwords and tokens are never recorded |
Sign-in uses an API token. The gateway prints the first admin token when it starts for the first time.
The Content sidebar shows how many records each collection has ("1,000+" means at least that many).
Colours, fonts and the corner radius are CSS variables. Edit public/theme.css (or the copy of it in the folder
the gateway serves, SETHUCMS_ADMIN_DIR, with no rebuild) and reload. The file explains which variables exist, and
how to keep text readable (contrast of at least 4.5:1). Replace logo.svg and favicon.svg next to it for your own logo.
The gateway can serve this app, so one command runs everything. From the sethucms repository:
sh scripts/build-all.sh # builds core, adapters, gateway and this app
sh scripts/run-local.sh # starts http://127.0.0.1:8080This app is built with pnpm build:embedded, which makes it call the address it was loaded from.
pnpm install
pnpm devWithout configuration the home page shows sample data and the other pages say they need a gateway.
To use a real gateway while developing, start it (sh scripts/run-local.sh in sethucms), then copy
.env.example to .env and set:
VITE_API_URL=http://127.0.0.1:8080
and allow the dev server's address in the gateway: SETHUCMS_ALLOWED_ORIGINS=http://localhost:5173.
| Path | What it does |
|---|---|
src/api/gateway.ts |
The one place that talks to the gateway: types, token handling, every request |
src/auth.tsx |
Sign-in state and the live-events hook |
src/router.ts |
Small hash router (#/content/conn_1/articles/42) |
src/components/ |
Pages (HomePage, ContentPage, ConnectionsPage, ...) and parts (RecordEditor, FieldInput, PreviewPane) |
src/lib/ |
Plain helpers: headline sentence, capability cells, relative time |
src/styles.css |
All styling, with colour and type tokens at the top. Light and dark themes |
public/theme.css |
Your brand overrides, loaded after the built-in styles |
The Content screens and the admin pages were checked with axe-core against WCAG 2.2 AA (light and dark, desktop and
a 390px phone) with no violations, and the Content screens do not scroll sideways at 320px wide. This is an automated and keyboard check, not
a full audit with a screen reader. Re-check after changing colours in theme.css.
- The token is kept in memory and
sessionStorage(cleared when the tab closes) and is sent only in theAuthorizationheader, never in a URL. - Fonts and images are bundled, never inlined as
data:URLs, so the gateway can serve the app with a strict Content-Security-Policy (everything from its own address only). - Error messages shown to people come from the gateway's standard error body. Database error text never reaches the browser.