sardine-cms-admin

The Sardine CMS admin panel: an authenticated FastAPI application serving both the admin API and the server-rendered UI (ADR-0013). It drives cms-core, cms-validation and cms-build through their public APIs — storage comes from create_storage(url), so every supported engine works unchanged.

pip install sardine-cms-admin
SARDINE_STORAGE_URL="sqlite:///content.db" uvicorn --factory cms_admin.app:create_app

The panel itself is multilingual (ADR-0022): each editor picks their language in the user menu (PT-PT, ES, FR and DE ship alongside English), with the browser's language as the fallback.

There are no default credentials — create the first account with the CLI, then sign in at /login:

cms admin create-user editor-in-chief -p my-project --role admin

The UI is built on AdminLTE 4 (MIT, vendored verbatim with its license — ADR-0017) and implemented exactly as its reference pages do: Source Sans 3 (OFL), Bootstrap Icons (MIT) and the theme's own behavior scripts (AdminLTE, Bootstrap bundle, OverlayScrollbars — ADR-0020) all ship as local files; the admin serves everything itself, no CDN, no inline scripts. The dashboard shows content by workflow status, the translation coverage matrix and a live validation report. Articles and pages are edited in the browser: EN source plus a side-by-side editor per translation, with state indicators from the checksum model and a preview rendered by the builder's own Markdown renderer (raw HTML disabled). The media library uploads with server-side validation (MIME sniffed from bytes, size limit, parsed image dimensions), manages mandatory EN + translatable alt text, and refuses to delete assets that articles or sections still reference. The workflow moves content through draft → review → published → archived with each transition owned by a rung of the role ladder; publishing runs the validation gate. The Publishing panel previews into /preview/ and builds/exports the project output with target extras, with every run recorded on the dashboard.

Configuration is environment-only (no config files with secrets):

Variable	Meaning	Default
`SARDINE_STORAGE_URL`	Storage URL for `create_storage`	`sqlite:///content.db`
`SARDINE_ADMIN_SESSION_HOURS`	Session lifetime in hours	`12`
`SARDINE_ADMIN_COOKIE_SECURE`	Set `0` only for plain-http local dev	`1`
`SARDINE_MEDIA_DIR`	Media upload directory (the project's)	`media`
`SARDINE_ADMIN_UPLOAD_MAX_MB`	Upload size limit in MB	`10`
`SARDINE_PROJECT_DIR`	Project directory (`sardine.toml`)	`.`
`SARDINE_ADMIN_PUBLISH_GATE`	Set `0` to publish despite validation errors	`1`

The full admin guide — configuration, roles, workflow, publishing, security model — is docs/ADMIN_GUIDE.md (anti-drift-checked). Milestone 3 status and the phased plan live in docs/PLAN.md.

Sardine CMS

Live demo: https://sardine.ph7x.com (admin demo at /admin/)
Repository: https://github.com/ph7x-Systems/sardine-cms
Documentation: https://github.com/ph7x-Systems/sardine-cms/wiki
License: Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sardine_cms_admin-0.5.0.tar.gz (717.5 kB view details)

Uploaded Jul 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sardine_cms_admin-0.5.0-py3-none-any.whl (765.8 kB view details)

Uploaded Jul 22, 2026 Python 3

File details

Details for the file sardine_cms_admin-0.5.0.tar.gz.

File metadata

Download URL: sardine_cms_admin-0.5.0.tar.gz
Upload date: Jul 22, 2026
Size: 717.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for sardine_cms_admin-0.5.0.tar.gz
Algorithm	Hash digest
SHA256	`80b5ab0749cc9f77e59dff2356878b8f46a79821f766e82e23aa0770f0cc7929`
MD5	`0d1ccedf62770713797b0e98450a4f99`
BLAKE2b-256	`0fabdc6b5ae0e37b5ac6d2ab5054adc80637be8e782b575042cee5f1d47af409`

See more details on using hashes here.

Provenance

The following attestation bundles were made for sardine_cms_admin-0.5.0.tar.gz:

Publisher: release.yml on ph7x-Systems/sardine-cms

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: sardine_cms_admin-0.5.0.tar.gz
- Subject digest: 80b5ab0749cc9f77e59dff2356878b8f46a79821f766e82e23aa0770f0cc7929
- Sigstore transparency entry: 2220308725
- Sigstore integration time: Jul 22, 2026
Source repository:
- Permalink: ph7x-Systems/sardine-cms@2e6cca1555756ca5455d32fbb36df25db3b815e9
- Branch / Tag: refs/tags/v0.5.0
- Owner: https://github.com/ph7x-Systems
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@2e6cca1555756ca5455d32fbb36df25db3b815e9
- Trigger Event: push