Portable single-file CMS for Astro — everything in one
.podfile.
orbiter.sh · Docs · No Node on your host? → Lander, the same admin on PHP hosting.
Content, media, schema, config, users — all in one SQLite database. Copy the file and your entire site moves with it. No cloud. No API keys. No external services.
your-site/
├── astro.config.mjs
├── content.pod ← your entire CMS lives here
└── src/pages/
└── blog/
└── [slug].astro
You need Node.js 20+ and npm 10+.
npx @a83/orbiter-cli init my-site
cd my-siteThe CLI creates a project folder, a .pod file with sample collections, and starts the admin automatically.
Open http://localhost:4322 and log in with admin / admin.
git clone https://github.com/aeon022/orbiter.git
cd orbiter
npm install
npm run seed # creates apps/demo/demo.pod with sample content
ORBITER_POD=$(pwd)/apps/demo/demo.pod npm run dev --workspace=packages/adminOpen http://localhost:4322 — login: admin / admin.
The demo includes Posts, Pages, Authors, Events, and Categories — all pre-filled with sample content and draft/published entries.
To also run the public demo Astro site:
npm run dev # → http://localhost:8080The admin runs as a self-contained Hono server on port 4322 — independent from the Astro dev server. It only needs a .pod file.
npm install # run from the repo root (installs all workspaces)
npm run seed # creates apps/demo/demo.pod if it doesn't exist yetDevelopment (with --watch, reloads on changes to src/):
ORBITER_POD=$(pwd)/apps/demo/demo.pod npm run dev --workspace=packages/adminProduction (single run, no watch):
ORBITER_POD=$(pwd)/apps/demo/demo.pod npm start --workspace=packages/adminNote: Use an absolute path (
$(pwd)/...). The server changes its working directory internally topackages/admin/, so relative paths resolve incorrectly.
Or run directly from the package directory:
cd packages/admin
ORBITER_POD=../../apps/demo/demo.pod npm run devhttp://localhost:4322
Automatically redirects to /login.html. Login:
Username: admin
Password: admin
Two terminals:
# Terminal 1 — Astro demo site (public)
npm run dev
# Terminal 2 — Standalone admin
ORBITER_POD=./apps/demo/demo.pod npm run dev --workspace=packages/admin- Demo site:
http://localhost:8080 - Admin:
http://localhost:4322
Both access the same demo.pod. Changes made in the admin are immediately visible in the demo site after a browser reload.
| Variable | Required | Default | Description |
|---|---|---|---|
ORBITER_POD |
yes | — | Path to the .pod file |
PORT |
no | 4322 |
HTTP port |
ADMIN_ORIGIN |
no | http://localhost:4321,http://localhost:4322 |
Allowed CORS origins (comma-separated) |
node -e "
import('@a83/orbiter-core').then(({ createPod, hashPassword }) => {
const db = createPod('./test.pod', { site: { name: 'Test' } });
hashPassword('admin').then(h => { db.insertUser(crypto.randomUUID(), 'admin', h, 'admin'); db.close(); });
});
"
ORBITER_POD=./test.pod npm run dev --workspace=packages/admincurl http://localhost:4322/health
# → { "ok": true, "pod": "/path/to/content.pod" }No Node on your host? Lander runs the same admin on ordinary PHP hosting (PHP 8.1+, SQLite): same SQL file (.pod, a plain SQLite database, only renamed), same Station interface, plus a live read API (/api/public/<collection>) for your site, music and video uploads, a preview button and an admin that is comfortable on phones and tablets. Docs: orbiter.sh/docs/lander. Source: aeon022/lander (MIT).
The standalone admin server — runs independently, no Astro required:
npm install @a83/orbiter-adminRequired to read content in your Astro pages via orbiter:collections:
npm install @a83/orbiter-integration @astrojs/node@^10
@astrojs/node@^10targets Astro 6 — use@astrojs/node@^9for Astro 5.
npm install @a83/orbiter-core # direct DB access / scripting
npm install -g @a83/orbiter-cli # orbiter init, add-user, export, pack, unpackThe Orbiter desktop app wraps the admin server in a native macOS and Windows application — no terminal, no npm, no Node.js required.
macOS — Download Orbiter-universal.dmg from GitHub Releases (läuft nativ auf Apple Silicon und Intel). Drag Orbiter.app to Applications, double-click to launch.
Gatekeeper-Hinweis: Da Orbiter nicht mit einer Apple Developer ID signiert ist, zeigt macOS beim ersten Start eine Warnung oder meldet „App ist beschädigt". Workarounds:
- Rechtsklicken → Öffnen im Finder (dann erscheint „Trotzdem öffnen")
- Systemeinstellungen → Datenschutz & Sicherheit → Trotzdem öffnen
- Bei „beschädigt"-Meldung: Quarantäne-Flag im Terminal entfernen:
xattr -cr /Applications/Orbiter.app
Windows — Download the .exe installer, run it, launch Orbiter from the Start menu.
On first launch, Orbiter asks whether to open an existing .pod or create a new one. When creating a new pod, you choose a template:
| Template | Collections | Demo content |
|---|---|---|
| Blank | — | — |
| Blog | Posts, Post-Kategorien | 2 posts (1 published, 1 draft) |
| Portfolio | Projects, Projekt-Kategorien | 2 projects + 2 categories |
| Business | Pages, Services, Team | 2 pages, 2 services, 1 team member |
| Events | Events, Event-Kategorien | 2 events + 2 categories |
| Dossier | Dossiers | 1 pilot dossier (39 fields in 6 groups: Content, Research, Evidence, Meta, Provenance, Agent) |
Every template sets up an admin / admin user so you can log in immediately. Change the password in Account settings.
File → POD wechseln… (⌘O) — opens a .pod file picker, restarts with the new pod.
File → Neuen POD erstellen… — file picker + template chooser, then restart.
Both options are also available via the menu-bar / system tray icon (right-click).
File → POD sichern… (⌘⇧S) — saves a timestamped copy of the active pod next to the original (e.g. content-backup-2026-06-19.pod). A confirmation dialog offers to reveal the file in Finder/Explorer.
When a new version is released on GitHub, the desktop app downloads it automatically in the background. A dialog appears: "Update downloaded — restart to apply?" with a Restart now button. Updates are delivered via GitHub Releases using electron-updater.
Check for updates manually: Hilfe → Nach Updates suchen…
cd apps/desktop
npm install
npm run dev # run in Electron without packaging
# Build universal DMG (arm64 + x64)
cd apps/desktop && electron-builder --macBuilt with Electron 42. The admin server runs inside a
utilityProcess.fork()— no system Node.js needed. ASAR packaging bundles all dependencies. The macOS build is a universal binary that runs natively on both Apple Silicon and Intel Macs.
// astro.config.mjs
import { defineConfig } from 'astro/config';
import orbiter from '@a83/orbiter-integration';
import node from '@astrojs/node';
export default defineConfig({
output: 'server', // required — admin UI needs SSR
adapter: node({ mode: 'standalone' }),
integrations: [
orbiter({ pod: './content.pod' }),
],
});Use output: 'hybrid' to pre-render your public pages while keeping the admin dynamic:
export default defineConfig({
output: 'hybrid',
adapter: node({ mode: 'standalone' }),
integrations: [orbiter({ pod: './content.pod' })],
});npx @a83/orbiter-cli init my-siteOr create the pod manually:
// scripts/setup.js
import { createPod, hashPassword } from '@a83/orbiter-core';
import { randomUUID } from 'node:crypto';
const db = createPod('./content.pod', {
site: { name: 'My Site', url: 'https://example.com', locale: 'en' }
});
const hash = await hashPassword('change-me');
db.insertUser(randomUUID(), 'admin', hash, 'admin');
db.close();node scripts/setup.js
npx astro dev
# → admin at http://localhost:4321/orbiter---
import { getCollection } from 'orbiter:collections';
const posts = await getCollection('posts');
---
<ul>
{posts.map(post => (
<li><a href={`/blog/${post.slug}`}>{post.data.title}</a></li>
))}
</ul>---
import { getCollection, getEntry } from 'orbiter:collections';
export async function getStaticPaths() {
const posts = await getCollection('posts');
return posts.map(post => ({ params: { slug: post.slug } }));
}
const post = await getEntry('posts', Astro.params.slug);
---
<article>
<h1>{post.data.title}</h1>
<div set:html={post.data.body} />
</article>A .pod file is a standard SQLite 3 database with a custom extension. Any SQLite tool can open it.
content.pod
├── _meta → site config, locale, build webhook URL, media backend config
├── _collections → schema definitions (JSON per collection)
├── _entries → all content from all collections
├── _versions → full version history per entry
├── _media → media metadata + optional BLOB data (see Media Backends)
├── _users → admin users (scrypt-hashed passwords)
└── _sessions → active login sessions (auto-pruned)
# Inspect with any SQLite tool
sqlite3 content.pod ".tables"
sqlite3 content.pod "SELECT slug, status, updated_at FROM _entries ORDER BY updated_at DESC LIMIT 10"| Module | Usage |
|---|---|
orbiter:collections |
Read published content in Astro pages (build-time) |
orbiter:db |
Access the pod path in admin routes (runtime) |
orbiter:collections is a static snapshot — it reads all published entries from the pod when Astro builds and inlines them as a JS module.
The integration injects a complete admin UI under /orbiter via Astro's injectRoute API. Nothing is added to your src/pages.
| Route | Page |
|---|---|
/orbiter |
Dashboard |
/orbiter/[collection] |
Collection list |
/orbiter/[collection]/[slug] |
Entry editor |
/orbiter/media |
Media library |
/orbiter/media/[id] |
Serve a media file (BLOB → HTTP) |
/orbiter/schema |
Schema editor |
/orbiter/settings |
Site settings + account |
/orbiter/users |
User management (admin only) |
/orbiter/build |
Build trigger |
/orbiter/import |
WordPress importer |
/orbiter/api/[collection] |
JSON API (authenticated) |
/orbiter/rss/[collection].xml |
RSS 2.0 feed per collection |
/orbiter/sitemap.xml |
XML sitemap of all published entries |
/api/public |
Discovery — lists all public collections, auth mode, links |
/api/public/openapi.json |
Auto-generated OpenAPI 3.1 spec |
/api/public/[collection] |
Public read-only API — list published entries |
/api/public/[collection]/[slug] |
Public read-only API — single entry with full body |
/llms.txt |
Machine-readable content index (llmstxt.org) |
/llms-full.txt |
Full body content dump for AI/RAG pipelines |
/orbiter/login |
Login |
/orbiter/logout |
Logout |
/orbiter/setup |
First-run setup wizard |
/orbiter/search |
Command palette search API |
// All published entries in default locale
getCollection(name: string): Promise<Entry[]>
// Single entry by slug (default locale)
getEntry(collection: string, slug: string): Promise<Entry | null>
// All published entries for a specific locale
getLocaleCollection(name: string, locale: string): Promise<Entry[]>
// Entry for a specific locale, falls back to default locale if not translated
getLocaleEntry(collection: string, slug: string, locale: string): Promise<Entry | null>
// Preview a draft entry (requires preview token from Settings → API)
getPreviewEntry(collection: string, slug: string, token: string): Promise<Entry | null>
// Configured locales (from Settings → Language)
locale: string // default locale, e.g. "en"
locales: string[] // all locales, e.g. ["en", "de", "fr"]{
id: string, // UUID
slug: string, // URL-safe identifier
status: 'published',
created_at: string, // ISO datetime
updated_at: string, // ISO datetime
data: {
title: string,
body: string, // richtext → Markdown-rendered HTML
image: string, // media field → UUID (use /orbiter/media/{id})
tags: string[], // array field → string array
author: Entry, // relation field → resolved Entry object
}
}<img src={`/orbiter/media/${post.data.image}`} alt={post.data.title} />For external media (GitHub backend or linked URLs), /orbiter/media/[id] issues a 302 redirect to the CDN or original URL — no change needed in templates.
Relation fields are resolved at build time — the raw UUID array is replaced with full Entry objects:
{posts.map(post => (
<div>
<h2>{post.data.title}</h2>
<p>by {post.data.author?.data?.name}</p>
{post.data.categories?.map(cat => (
<span>{cat.data.name}</span>
))}
</div>
))}In the block editor, typing [[ opens a floating entry picker. Selecting an entry inserts an inline link chip. In the stored body, wikilinks are serialized as:
[[Title|collection/slug]]
When rendering entry bodies in Astro, replace wikilinks with HTML links:
---
const body = post.data.body?.replace(
/\[\[([^\]|]+)\|([^\]]+)\]\]/g,
(_, title, href) => `<a href="/${href}">${title}</a>`
) ?? '';
---
<div set:html={body} />The collection/slug part maps directly to your Astro page routes, e.g. [[Orbiter v0.2|posts/orbiter-v0-2-0]] → /posts/orbiter-v0-2-0.
In the admin, editors can save any entry as a reusable template (sidebar → "Template" section). Templates are stored as templates.{collectionId} meta keys and are not exposed through orbiter:collections — they are admin-only. The ⌗ button in the entries list opens the template picker to pre-fill new entries.
| Type | Input | Stored as | TypeScript type |
|---|---|---|---|
string |
Single-line text | TEXT |
string |
richtext |
Block editor (Markdown) | TEXT |
string |
boolean |
On/Off toggle | TEXT |
boolean |
number |
Numeric | TEXT |
number |
url |
URL with validation | TEXT |
string |
email |
Email with validation | TEXT |
string |
date |
Date picker | TEXT (ISO date) |
string |
datetime |
Date + time picker | TEXT (ISO datetime) |
string |
select |
Dropdown | TEXT (option key) |
union of option values |
array |
Tag input | TEXT (JSON array) |
string[] |
weekdays |
Weekday multi-select | TEXT (JSON array) |
string[] |
image |
Image picker (upload or library) | TEXT (media UUID) |
string |
file |
File picker — PDF, document, download | TEXT (media UUID) |
string |
table |
Mini-spreadsheet — rows & columns | TEXT (JSON 2D array) |
string[][] |
media |
Media library picker (any type) | TEXT (media UUID) |
string |
relation |
Entry picker (cross-collection) | TEXT (JSON array of UUIDs) |
EntryType[] |
{
type: 'string', // required
label: 'Post Title', // display name in editor
required: true,
// select fields:
options: ['news', 'event'],
optionLabels: { news: 'News', event: 'Event' },
// relation fields:
collection: 'authors',
multiple: true,
// conditional visibility:
showWhen: 'category:event', // show only when `category` equals `event`
// field grouping (editor sidebar):
group: 'Research', // collapsible group header in the editor
// table format:
format: 'apa7', // APA7 citation preview below the table
}image / file / media — all store a media UUID. Resolve to a URL in Astro:
---
const imgUrl = `/api/media/${entry.data.cover}/raw`;
const fileUrl = `/api/media/${entry.data.brochure}/raw`;
---
<img src={imgUrl} alt="" />
<a href={fileUrl}>Download PDF</a>table — stored as string[][]. First row is the header. Table fields with format: 'apa7' render an APA7-formatted citation preview below the table (supports book, article, chapter, report, website):
---
const rows = entry.data.prices; // string[][]
const [header, ...body] = rows;
---
<table>
<thead><tr>{header.map(h => <th>{h}</th>)}</tr></thead>
<tbody>{body.map(r => <tr>{r.map(c => <td>{c}</td>)}</tr>)}</tbody>
</table>relation — returns an array of entry IDs by default. Use getEntry() to resolve:
---
import { getCollection, getEntry } from 'orbiter:collections';
const posts = await getCollection('posts');
// Resolve relation:
const author = await getEntry('authors', post.data.author[0]);
---Orbiter exposes a read-only JSON API for all collections:
GET /orbiter/api/[collection]
Returns all published entries as a JSON array.
Authentication (optional): add a Bearer token in Settings → API Token, then pass it as a header:
curl https://your-site.com/orbiter/api/posts
# or with token:
curl -H "Authorization: Bearer your-token" https://your-site.com/orbiter/api/postsResponse shape:
[
{
"id": "uuid",
"slug": "my-post",
"status": "published",
"created_at": "2025-01-01T00:00:00Z",
"updated_at": "2025-06-01T12:00:00Z",
"data": {
"title": "My Post",
"body": "<p>...</p>"
}
}
]Orbiter exposes a public, unauthenticated read-only API for AI agents, mobile apps, and third-party frontends. Unlike the admin JSON API, it requires no session cookie and supports wide CORS.
In Settings → Public API collections, enter a comma-separated list of collection IDs to expose, or * to expose all:
posts, pages
curl https://your-site.com/api/publicReturns the site name, auth mode, all public collections with entry counts, and links to the OpenAPI spec and llms.txt.
curl https://your-site.com/api/public/posts
curl https://your-site.com/api/public/posts?limit=10&offset=0&q=astroResponse:
{
"collection": "posts",
"total": 42,
"limit": 10,
"offset": 0,
"entries": [
{
"slug": "hello-world",
"title": "Hello World",
"excerpt": "...",
"date": "2026-06-28",
"author": "Ada Lovelace",
"image": null,
"tags": ["astro", "cms"],
"url": "https://your-site.com/posts/hello-world"
}
]
}curl https://your-site.com/api/public/posts/hello-worldReturns the full entry including body (HTML), publishedAt, and seo fields.
curl https://your-site.com/api/public/openapi.jsonAuto-generated OpenAPI 3.1 spec from your live pod schema. Import into Postman, Swagger UI, or any AI tool.
Enable Require API key in Settings to restrict access. Generate named keys in Settings → API Keys and pass them as a Bearer token:
curl -H "Authorization: Bearer orb_xxxxx" https://your-site.com/api/public/postsUse Git sync mode when your hosting platform has an ephemeral filesystem — Netlify, Vercel, GitHub Pages, Cloudflare Pages. These platforms spin up fresh containers for each build; any file written at runtime is gone on the next deploy.
Git sync solves this by keeping the pod and its media files in your git repository. The admin runs on a persistent server (Railway, VPS, Coolify) and writes to the pod normally. Before committing, you extract media BLOBs to plain files. At build time on CI, you restore them.
If your media library is large (hundreds of images, gigabytes), consider the S3 or GitHub media backend instead — they keep blobs out of the pod entirely and don't require git sync for media.
# Extract media BLOBs from pod to files (run locally before git commit)
orbiter unpack --pod ./content.pod --out ./media
# Restore BLOBs from files back into pod (run on CI before astro build)
orbiter pack --pod ./content.pod --dir ./mediaLocal machine (persistent server or laptop):
1. Edit content in the Orbiter admin
2. orbiter unpack --pod ./content.pod --out ./media
3. git add content.pod media/ && git commit && git push
CI (GitHub Actions / Netlify build):
4. git checkout → gets pod + media files
5. orbiter pack --pod ./content.pod --dir ./media → restores BLOBs into pod
6. npx astro build → reads pod via orbiter:collections, generates static output
7. Deploy to Netlify / GitHub Pages / etc.
# .github/workflows/build.yml (generated by orbiter init)
name: Build & Deploy
on:
push:
branches: [main]
workflow_dispatch:
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '20'
- run: npm install
- run: npx @a83/orbiter-cli pack --pod ./content.pod --dir ./media
- run: npx astro build
- uses: actions/deploy-pages@v4 # or peaceiris/actions-gh-pages| Git sync | S3/GitHub backend | |
|---|---|---|
| Setup | Simple — just two CLI commands | Needs S3 bucket or GitHub repo |
| Pod stays small | No — blobs in pod (and in git history) | Yes — pod only has metadata |
| Works offline | Yes — everything in git | Needs network to serve media |
| Best for | Small sites, < 50 MB media total | Large or growing media libraries |
Import content from a WordPress WXR export directly in the admin:
- In WordPress: Tools → Export → All content → download the
.xmlfile - In Orbiter admin: Import → upload the WXR file
- Choose which post types to import
- Orbiter converts:
- Post titles, slugs, dates, status (published/draft)
- HTML body content → Markdown (via
turndown) - Categories and tags → array fields
- Featured images → downloaded and stored as BLOBs in the media library
No CLI required — the entire import runs in the browser via the admin UI.
Each entry has a locale field in the database. The first locale in Settings → Language → Locales maps to the default (locale = ''), additional locales are stored as their language code ('de', 'fr', etc.).
Configure locales in Settings → Language — the locale switcher appears automatically in the entry editor. Create translation variants from the locale tabs; the slug stays the same across all locales.
---
import { getCollection, getLocaleCollection, getLocaleEntry, locales } from 'orbiter:collections';
// Default locale only
const posts = await getCollection('posts');
// All German posts
const dePosts = await getLocaleCollection('posts', 'de');
// A specific entry in German, falls back to default locale if not translated
const post = await getLocaleEntry('posts', 'my-post', 'de');
---Static paths for multilingual sites:
export async function getStaticPaths() {
const posts = await getCollection('posts'); // default locale entries
return posts.flatMap(post =>
locales.map(loc => ({ params: { slug: post.slug, lang: loc } }))
);
}
const { lang, slug } = Astro.params;
const post = await getLocaleEntry('posts', slug, lang); // falls back to defaultnpm install -g @a83/orbiter-cli| Command | Description |
|---|---|
orbiter init [dir] |
Scaffold a new Astro + Orbiter project |
orbiter add-user |
Add a user to an existing pod |
orbiter export |
Export content to JSON or Markdown files |
orbiter unpack |
Extract media BLOBs from pod to files (Git sync) |
orbiter pack |
Restore media BLOBs from files into pod (Git sync) |
orbiter status [pod] |
Show pod health: entry counts, size, users, Public API info |
orbiter init my-site
orbiter add-user --pod ./content.pod
orbiter export --pod ./content.pod --out ./export --format md
orbiter unpack --pod ./content.pod --out ./media
orbiter pack --pod ./content.pod --dir ./media
orbiter status # reads ./content.pod by default
orbiter status ./path/to/content.podOrbiter ships a framework-agnostic client: @a83/orbiter-client.
npm install @a83/orbiter-clientimport { createClient } from '@a83/orbiter-client';
const orb = createClient('./content.pod');
export async function load() {
const posts = orb.getCollection('posts'); // all published entries
return { posts };
}Same API — call it in a load() function. For prerender = true the client opens the pod at build time.
// src/routes/posts/[slug]/+page.ts
import { createClient } from '@a83/orbiter-client';
export const prerender = true;
export async function load({ params }) {
const orb = createClient('./content.pod');
const post = orb.getEntry('posts', params.slug);
if (!post) throw error(404);
return { post };
}
export async function entries() {
const orb = createClient('./content.pod');
return orb.getCollection('posts').map(p => ({ slug: p.slug }));
}const orb = createClient(podPath);
orb.getCollections() // → Collection[]
orb.getCollection(id) // → Entry[] (published, all locales)
orb.getEntry(collectionId, slug) // → Entry | null
orb.getMedia() // → MediaItem[]
orb.getMediaItem(id) // → MediaItem | nullExpose a pod's content as tools for AI agents (Claude Desktop, Claude Code, or any MCP client) via @a83/orbiter-mcp: list_collections, get_entries, get_entry, search_content.
npm install -g @a83/orbiter-mcpstdio (local, Claude Desktop) — full access, no auth, same trust level as running orbiter-admin locally:
{
"mcpServers": {
"orbiter": {
"command": "orbiter-mcp",
"env": { "ORBITER_POD": "/absolute/path/to/content.pod" }
}
}
}HTTP (remote) — same restrictions as the Public Content API (API key + public.collections opt-in, published entries only):
orbiter-mcp --http --port 4500See packages/mcp/README.md for the full tool reference.
Entry counts per collection, recently edited entries, persistent scratchpad + todo list, build trigger status.
All schema fields rendered as inputs. Richtext block editor with live Markdown preview, autosave, version history, draft/published toggle. Inline image blocks with float alignment (left/right/center/full). Video embedding (YouTube, Vimeo, mp4). Media picker with three tabs: Library (browse pod), From URL (server-side import from Dropbox/Drive/OneDrive), External link (store URL reference without fetching). Relation picker, conditional field visibility. Required field validation before save. Scheduled publishing (set publish_at) and content expiry (unpublish_at). Per-entry editorial comments with resolve/unresolve. Entry locking — warns when another user is already editing the same entry. Version history with restore per snapshot.
Multilingual: When locales are configured (Settings → Language), a locale tab bar appears below the editor toolbar. Each tab shows existing locale variants; dashed tabs are untranslated. Click a dashed tab to create that translation variant.
Upload, browse, and manage files. Images, video, PDF, and any file type. Served at /orbiter/media/[id] — BLOB, disk file, or CDN redirect depending on configured backend. Folder categories, type filter, inline image and video preview, copy URL, alt text. Automatic image optimization on upload (resize + compress via sharp, configurable in Settings).
Add, edit, delete, and reorder fields on any collection. Changes take effect immediately — no migration or restart needed. Export schema as JSON and import from file to copy schemas between collections or pods.
Trash (soft delete + restore + permanent delete), activity log, bulk actions (publish/draft/delete/restore), drag-to-sort, scheduled status tab. CSV export and import per collection for bulk content management. When locales are configured, locale filter tabs appear in the filter bar.
Tools → Inbox — receives contact and booking form submissions from your Astro site via POST /api/form/:formId. Each form ID is a separate tab. Actions per submission: mark as read / done / confirmed / rejected / spam, reply by email (inline compose panel), delete. SMTP config in Settings → Email.
Tools → Snippets — built-in Astro code library. Snippets are generated from your live pod state: collection names, admin origin, and available schemas. Categories: Setup, Content, SEO, Forms, Events, Integration. Each card has a copy button. Press g p in Space Station mode.
⌘ K / Ctrl K — fuzzy search across all content and navigation from any admin page.
Ten themes × two schemes (dark/light) × three styles (Classic, Glass, Station), switchable in Settings → Appearance, plus font choice, custom colours and UI zoom:
Space (default), missionctl, Zen, Catppuccin, Terminal, Paper, Nord, Gruvbox, Dracula, Tokyo Night.
Layouts: Classic (sidebar + content grid) or Station (Space Station mode — floating magnification dock, HUD panel with stats/notes, frosted glass page headers). Layout and theme saved to localStorage.
Schema fields with a group property are rendered as collapsible sections in the editor sidebar. First two groups and groups containing APA7 fields auto-expand. Collections without groups render flat as before — fully backward compatible.
Table fields with format: 'apa7' display a formatted citation list below the table. Default headers: Author, Year, Title, Source, URL, Type. Supports book, article, chapter, report, and website formats. Preview updates live on every keystroke.
Export collections as shareable JSON templates (POST /api/templates/export). Import template JSON files (POST /api/templates/import). List built-in templates with install status (GET /api/templates/available). Install a built-in template into an existing POD (POST /api/templates/install/:id). Settings UI with template buttons, export checkboxes, and import file picker. Automatic nav.groups configuration on template install.
Installing a template is always additive, never destructive. If a collection already exists, it is skipped — no data, schema, or entries are overwritten. Only missing collections are created.
To update a schema without losing entries, use Schema → Import Schema — this overwrites only the field definitions while all entries remain intact. Deleting a collection removes all its entries permanently.
| Action | Schema | Entries |
|---|---|---|
| Install template (collection doesn't exist) | ✅ created | ✅ demo entries |
| Install template (collection exists) | ⏭ skipped | ⏭ skipped |
| Import schema (↑ Import Schema) | 🔄 overwritten | ✅ preserved |
| Delete collection + reinstall | ✅ created | ❌ lost |
Collections support nav.hidden (hide from sidebar/dock) and nav.groups (group into drawer sections) meta keys. Sidebar renders collapsible nav groups with hover-to-peek. Dock in Station mode shows hexagon drawer items with triangle indicator; hover opens a popup with collection links and preview cards. Settings UI: per-collection visibility toggle and group assignment.
/ai slash command and toolbar button in the block editor. Summarize, translate, generate SEO text, adjust tone. Supports Ollama (local, free) or OpenAI/Anthropic API keys. Configurable in Settings → AI. Preset pills for common tasks. No cloud lock-in.
The admin is installable as a Progressive Web App on mobile and desktop. Service worker caches assets, offline page shown when disconnected.
Cookie-based sessions. Passwords hashed with scrypt (Node.js built-in).
Roles:
| Feature | editor | admin |
|---|---|---|
| Create / edit / delete entries | ✅ | ✅ |
| Manage media | ✅ | ✅ |
| Edit schema | ✅ | ✅ |
| Site settings | ✅ | ✅ |
| Manage users | ❌ | ✅ |
Orbiter uses better-sqlite3 — a native Node.js module. It requires a real Node.js runtime with filesystem access.
| Adapter | Supported | Notes |
|---|---|---|
@astrojs/node |
✅ Recommended | Standalone or middleware mode |
@astrojs/netlify |
Serverless FS is ephemeral — use Git sync for editing | |
@astrojs/vercel |
Same as Netlify | |
| Cloudflare Workers | ❌ | No native Node.js support |
npm install @astrojs/node@^9
npx astro build
node dist/server/entry.mjsWorks on: VPS (Hetzner, DigitalOcean), Railway, Render, Fly.io, Docker.
Docker:
FROM node:20-alpine
WORKDIR /app
COPY . .
RUN npm install && npx astro build
EXPOSE 3000
CMD ["node", "dist/server/entry.mjs"]# Mount .pod as a volume so it persists across container restarts
docker run -p 3000:3000 -v $(pwd)/content.pod:/app/content.pod my-orbiter-site┌─────────────────────────────┐ build hook ┌──────────────────────┐
│ Orbiter Admin │ ────────────▶ │ Netlify / Vercel │
│ (VPS or Railway) │ │ (static frontend) │
│ /orbiter ← edit content │ │ / ← visitors │
│ content.pod ← persists │ └──────────────────────┘
└─────────────────────────────┘
- Run the Orbiter admin on a Node.js server with a persistent
.podfile - Edit content, click Trigger build
- Netlify/Vercel fetches the repo + pod, runs
astro build, deploys static HTML
Orbiter fires the webhook automatically whenever an entry transitions from draft to published. The same URL is also triggered manually via Trigger build in the dashboard.
Configure the webhook URL in Settings → Build.
Netlify: Site configuration → Build & deploy → Build hooks → Add build hook
Vercel: Project settings → Git → Deploy Hooks
GitHub Actions: Use repository_dispatch — add a small serverless proxy to inject the Authorization header before forwarding to GitHub's API.
Orbiter supports four storage backends for media files, configured in Settings → Media storage (no restart required — stored in the pod).
| Backend | How it works | Best for |
|---|---|---|
blob |
File data stored as BLOB in the .pod file (default) |
Small–medium sites, simplest setup |
local |
Files written to a directory on the server | Self-hosted VPS with persistent disk |
github |
Files uploaded via GitHub Contents API, served from jsDelivr CDN | Open-source sites, free global CDN |
s3 |
Files uploaded to any S3-compatible bucket | Large media libraries, high traffic |
link |
External URL stored — no data fetched or copied | Dropbox, Google Drive, Cloudinary, any public URL |
If your site has hundreds of high-res images or your pod is growing into gigabytes, switch away from blob:
- Self-hosted VPS → use
local. Files sit next to the pod on disk, served directly. Zero egress cost. - Open-source / public repo → use
github. Files go to a GitHub repo and are served from jsDelivr's global CDN for free. - Any serious production site → use
s3with Cloudflare R2 (free egress), Backblaze B2, or AWS S3. Pod stays small and portable; media scales independently.
Switching backends does not delete existing blobs — rows keep their backend column value. Use Settings → Media storage → Migrate to move existing blobs to the new backend (pulls each blob, pushes to target, nulls the blob column in the pod).
No configuration. Files stored inline in the pod. Works everywhere, but pod size grows with every upload.
Media backend: local
Media path: ./media (relative to pod, or absolute)
Files written to the filesystem. Served via /api/media/:id (stream). Best for a VPS where you have a persistent disk — pair with a cron job or rsync for backup.
Media backend: github
Repository: owner/media-repo
Branch: main
Directory: media
GitHub token: ghp_… (needs repo write scope)
On upload Orbiter pushes the file via GitHub Contents API. Files are served from cdn.jsdelivr.net/gh/owner/repo@branch/path — no egress cost, globally cached. 1 GB free for public repos.
Works with Cloudflare R2, Backblaze B2, AWS S3, MinIO, or any S3-compatible endpoint.
Media backend: s3
S3 bucket: my-media-bucket
S3 region: auto (use 'auto' for R2, your region for AWS)
S3 endpoint: https://…r2.cloudflarestorage.com (omit for AWS)
S3 access key ID: …
S3 secret key: …
S3 public URL: https://cdn.mysite.com (optional — for custom domain / public bucket)
If S3 public URL is set, media is served via a direct redirect to that URL (no proxying through Orbiter). Otherwise Orbiter fetches the object and streams it.
Cloudflare R2 has zero egress cost and a generous free tier — it's the recommended choice for most production deployments.
Use the External link tab in the image picker to store a URL reference without downloading anything. Works with Dropbox share links, Google Drive, OneDrive, Cloudinary, and any publicly accessible URL. Orbiter makes a HEAD request to detect the mime type, then stores only the URL. /orbiter/media/[id] issues a 302 redirect — no change needed in your templates.
orbiter/
├── apps/
│ ├── demo/ ← demo Astro site
│ │ ├── astro.config.mjs
│ │ ├── demo.pod ← generated by npm run seed
│ │ └── scripts/seed.js
│ └── landing/ ← orbiter.sh marketing site (Astro/static)
│
├── packages/
│ ├── core/ ← @a83/orbiter-core
│ │ └── src/
│ │ ├── index.js ← public API
│ │ ├── db.js ← OrbiterDB (SQLite wrapper)
│ │ ├── pod.js ← createPod / openPod
│ │ ├── auth.js ← hashPassword / verifyPassword / generateToken
│ │ └── media-backend.js ← BlobBackend / LocalBackend / GitHubBackend
│ │
│ ├── admin/ ← @a83/orbiter-admin
│ │ ├── src/
│ │ │ ├── server.js ← Hono server entry point (port 4322)
│ │ │ ├── middleware/ ← auth middleware
│ │ │ └── routes/ ← entries, media, collections, meta, build, auth
│ │ └── public/ ← vanilla JS + CSS admin UI (no build step)
│ │ ├── dashboard.html
│ │ ├── editor.html
│ │ ├── media.html
│ │ ├── settings.html
│ │ └── style.css
│ │
│ ├── integration/ ← @a83/orbiter-integration
│ │ ├── src/
│ │ │ ├── index.js ← Astro integration + virtual modules
│ │ │ ├── admin-utils.js ← theme, dark mode, command palette
│ │ │ ├── i18n.js ← EN/DE translations
│ │ │ └── wp-importer.js ← WordPress XML importer
│ │ ├── routes/ ← all /orbiter/* admin pages
│ │ └── styles/admin.css
│ │
│ └── cli/ ← @a83/orbiter-cli
│ ├── bin/orbiter.js
│ └── src/
│ ├── init.js
│ ├── add-user.js
│ ├── export.js
│ ├── pack.js ← Git sync: restore BLOBs into pod
│ └── unpack.js ← Git sync: extract BLOBs from pod
│
└── package.json ← npm workspace root
| Script | Description |
|---|---|
npm run dev |
Start demo app dev server (port 8080) |
npm run seed |
Recreate demo.pod with fresh sample data |
npm run build |
Build the demo app |
npm run publish:core |
Publish @a83/orbiter-core to npm |
npm run publish:integration |
Publish @a83/orbiter-integration to npm |
npm run publish:cli |
Publish @a83/orbiter-cli to npm |
npm run publish:all |
Publish all three packages |
# Bump versions
npm version patch --workspace=packages/core
npm version patch --workspace=packages/integration
npm version patch --workspace=packages/cli
# Dry run first
npm pack --workspace=packages/core --dry-run
npm pack --workspace=packages/integration --dry-run
# Publish (core first — integration and CLI depend on it)
npm publish --workspace=packages/core --access=public
npm publish --workspace=packages/integration --access=public
npm publish --workspace=packages/cli --access=publicRelease checklist:
- All three package versions bumped
npm pack --dry-runis clean (no secrets, no.podfiles)git statusis clean- Git tag pushed:
git tag v0.x.x && git push origin v0.x.x
The admin ships with English and German. To add a locale, add translations to packages/integration/src/i18n.js and add the language option to routes/settings.astro and routes/setup.astro.
The full, current changelog lives on orbiter.sh/changelog. Entries from admin 0.3.81 on are mirrored here.
Nov 2026 · admin@0.3.111 · lander@0.7.5 — Fix: Save and Publish were not tappable in the phone editor
- What was wrong. Since admin 0.3.109 and Lander 0.7.3 the fade at the right edge of the editor toolbar used a CSS mask, which trapped the floating Save · Publish button: it showed, but a tap did not reach it. Update to admin 0.3.111 or Lander 0.7.5.
- Lander also: tapping a list row opens the entry again (it only worked after "select all" since 0.7.0).
- Dock labels and drawers — on touch devices every dock item shows its name. A drawer opens as a floating glass panel above the dock (like Notes and To-do) with a close button; tapping outside closes it.
- Lists on a phone — one main action per row plus a “⋯” menu (edit, duplicate, trash). Swipe left for the menu, swipe right to publish or unpublish (asks first). Slug and repeated names stay out of the card; filter chips scroll in one line.
- Editor — the floating save button no longer covers the last field, the toolbar fades out where it scrolls, a pulsing dot shows unsaved changes, and Preview opens the site in a sheet.
- Touch targets — buttons, chips, fields and calendar days are at least 40–44 px high on touch screens; forms use a calmer sans-serif instead of monospace.
- Draft badges — the dock shows how many drafts a collection or drawer holds. Empty lists get a call to action, loading lists a shimmer.
- Lander — the admin is German by default (switch under Settings → Admin language). Update with one click in Settings → Pod.
- Sliding pill — one glass pill follows the item under the cursor with a spotlight, and rests behind the active item with a slow aurora ring. It stays on a drawer while you reach into it, and returns only after a short grace period.
- Pages swap in place — dock and status bar stay put, the old page stays until the new one is ready (thin progress bar), pages are prefetched on hover or touch and cached for five minutes. Editor, calendar, users and a few others still reload fully.
- Soft transitions — a quick fade with a hint of blur and lift; full page loads use the browser’s view transitions where available. Off for “reduce motion”.
- Instant dock — the dock is drawn from the last
/api/infoanswer on the first frame and rebuilt only if something changed. The cache is cleared on sign-out. - Versioned assets — scripts and styles carry
?v=…and may stay in the browser cache for a year; the version changes with every file change. Lander needsmod_headersandmod_rewritefor the long cache (it still works without). - Recently visited — the command palette (⌘K) lists the last pages you opened. Kept in this browser only.
- Security — the page cache expires and notices a lost session instead of showing an empty page.
- Audio and video uploads — MP3, M4A, AAC, OGG, WAV, FLAC, MP4, WebM and MOV, served with range requests so Safari can play and seek. The upload limit is 40 MB for new installs.
- Preview — a Preview button opens the real website page for an entry, drafts included while you are signed in (Settings meta
site.previewandsite.url). - Quick-create — the “new entry” dialog asks for the list columns (title, band, date, place) and can publish right away. Copy with a new date duplicates an entry and renames its slug.
- Relations — a relation field can be single-choice (
multiple: false), shown as a dropdown; list columns show the related title. - Editor role — editors see a short dock (no schema, users, build, import) and the server refuses those actions with 403. Plain-language save errors replace “Error”.
- Installable — web-app manifest and icons, iOS meta tags and safe areas, so the admin can live on the home screen.
- "More" drawer — with more than six ungrouped collections the extra ones move into a drawer instead of stretching the dock.
- Short dock names — long titles are shortened to their first part (no more "…"); the full name stays in the tooltip.
- Never wider than the screen — long drawers scroll. Group collections by topic in Settings → Navigation. Update with one click in Settings → Pod.
- Nonce on every script — the admin pages are served through PHP with a one-time nonce and a strict policy. An injected
<script>oronerror=handler cannot run, the same protection Orbiter got in 0.3.98. - No inline handlers — all 81
onclick-style handlers moved todata-on-click. Behaviour is unchanged. Works at the domain root and in a subfolder, in English and German. - Earlier today (0.5.6): the pod and its backups are written owner-only (600). If a page looks odd after updating, hard-reload once. Docs →
- Random start password — a new pod no longer gets
admin / admin. The app creates a random password and shows it once after creating the pod. - Loopback address — the app talks to
127.0.0.1instead oflocalhost(you sign in once again after the update, the address is a new site for the browser cookie). - No browser permissions — camera, microphone, location and notification requests are always denied.
- Includes the current admin: enforced Content-Security-Policy, German interface, signed backups and Digi-ID sign-in. The macOS app is still unsigned (open it with right-click → Open).
- Automatic backups were world-readable. Since 0.3.96 (Orbiter) the automatic backup landed in a
backups/folder next to the pod with default permissions (644). If that folder lies inside a directory the web server serves, the backup (password hashes, saved settings) could be downloaded by anyone who guessed the file name. Backups are now written with mode 600 in a 700 folder. - What to do: update, then check that
https://your-host/backups/and old*.podfiles are not reachable, and delete old backups from a served folder. If one was exposed, change the user passwords and any SMTP, API or FTP secrets stored in the pod. SetORBITER_BACKUP_DIRto a folder outside the web root for good measure. - Lander also writes the pod and its backups owner-only (600), so a host that ignores
data/.htaccessdoes not expose them. Lander'sdata/.htaccessalready blocked the folder on Apache.
- The editor already saved the title and the text two seconds after typing. Now all other fields (text fields, dates, switches, dropdowns) autosave the same way, so a notice or a short entry no longer needs a manual save.
- Autosave keeps the entry's current status: a published entry goes live with the change (after the short public cache), a draft stays a draft.
- Shorter dock labels in German (Start, Nutzer, To-dos, Setup, Auto …), so the dock fits more items.
- Own order for collections — the setting
nav.order(a list of collection IDs) decides the order in the dock and the sidebar; collections not listed follow after. Set it withPUT /api/metaor in the pod.
Nov 2026 · admin@0.3.101 · lander@0.5.1 — Fix: Account page (2FA, Digi-ID) did nothing after in-app navigation
- Opening Account through the dock or sidebar swapped the page in place, so its scripts did not run: the 2FA card stayed on “Loading…” and “Link an address” did nothing until a hard refresh. The page now loads normally.
- Digi-ID for Lander — link a DigiByte address under Account, then scan the QR code on the login page. Same contract as Orbiter 0.3.99. Needs PHP
gmporbcmath(the signature check is done in PHP, no extra library to install). - Fix (admin 0.3.100, Lander) — the sign-in request now sends a JSON body: some hosts and proxies answer a body-less POST with 403. Docs →
- Passwordless sign-in — link a DigiByte address under Account → Digi-ID, then scan the QR code on the login page with a Digi-ID wallet. The password login stays.
- Bound to your domain — the wallet signs a one-time URI that contains the site address; challenges expire after five minutes and work once. Linking or removing an address needs the password. Docs →
- Needs a public HTTPS address (not
localhostor the desktop app). LegacyD…addresses.
- Rebuild on publish — a build webhook (Settings → Build) is called whenever an entry is published, so a static Astro site on Netlify, Vercel or GitHub Actions rebuilds itself.
- Signed webhooks — publish and delete events with an HMAC-SHA256 signature, a log of the last 50 deliveries and a test button. Same contract as Orbiter. Docs →
- 2FA for Lander — Settings → Security. Works with Google Authenticator, 1Password and Aegis; eight one-time recovery codes; a code cannot be replayed; wrong codes are throttled per account.
- Same format as Orbiter, so an Orbiter pod with 2FA users can move to Lander (before, Lander refused to sign these accounts in). Install it with Update now.
- Scripts need a nonce — the admin now blocks every script that is not part of its own pages. An injected
<script>oronerror=handler in content cannot run, even if it slipped past escaping. - No inline handlers — all 95
onclick="…"style handlers are replaced bydata-on-clickattributes handled by a small dispatcher (noeval). Behaviour is unchanged. - Custom admin pages that still use inline handlers: switch to
data-on-…, or setORBITER_CSP=reportto go back to report-only. Docs →
- Admin language DE — Settings → General → Admin language now switches the whole interface to German: navigation, dashboard, entries, editor, media, users, settings, import and analytics (about 600 labels and hints). Anything not translated yet stays English.
- The choice is kept per browser. The strings live in
i18n-de.js; your own content, the editor text and form fields are never touched. More languages can be added the same way. - Lander 0.3.2 gets the same German interface. It is the first release installed with the signed one-click update.
- Update now — the Lander admin installs a newer release with one click, from the dashboard hint or Settings → Pod.
- Signed releases — every release ZIP carries an Ed25519 signature that Lander checks before it writes a file. A tampered download is refused and nothing changes.
- Rollback copy — the pod and the current code are saved to
data/update-rollback/first. Config,data/, media and the subfolder paths stay as they are. - Needs the PHP
zipandsodiumextensions; otherwise the admin says why and you replace the files by hand.update_check => falseswitches it off. Docs →
- Installer — open
install.phponce; it detects a subfolder or domain root, writes the config, creates the first admin and deletes itself. - Subfolder or subdomain —
example.at/lander/works as well asredaktion.example.at. - Users — admins add editors and admins, reset passwords and delete accounts.
- Backup and restore — weekly automatic backups, SQL file or ZIP with media, restore with validation.
- Image sizes —
?w,?arand?fmtvariants with a cache; public/api/public/media/<id>. - Inbox visible in the menu, a short public cache (10 s by default) and an update hint. Lander →
Nov 2026 · admin@0.3.96 · core@0.3.22 — Automatic backups, pod size watch, media out of the pod, stronger password hashing
- Automatic backups — the pod is copied to a
backups/folder every 7 days (keeps four), plus Back up now. Configurable withORBITER_BACKUP_DAYS,_KEEP,_DIR. Docs → - Pod size watch — Settings → Pod shows the file size and the media inside it; the dashboard warns above
ORBITER_POD_WARN_MB(default 60) or when no backup exists. - Move media out of the pod — with a media backend set (local folder, S3, GitHub), one button moves the files out and shrinks the pod. A file that fails stays where it is.
- Stronger password hashing — scrypt with a higher cost, stored with the hash; old hashes keep working and are upgraded at the next sign-in. Docs →
- Download a backup — Settings → Pod → Download SQL file gives you a consistent copy of the live pod (no sessions), and shows the current file size. Docs →
- Restore or move — upload a
.pod: it is checked first (SQLite, integrity, required tables, at least one admin), the current pod is kept as<pod>.before-restore-…, then swapped in. Works for moving to another server, and for pods from Lander.
Nov 2026 · admin@0.3.94 · integration@0.3.23 · mcp@0.1.6 — Lander for PHP hosting, security hardening, 10 themes and a tidier Settings page
- Lander — the Orbiter admin on ordinary PHP hosting (PHP 8.1+, SQLite, no Node). Same SQL file (
.pod), same Station interface, live read API for your site. Lander → Docs → - Security hardening — user-supplied values are now escaped everywhere in the admin UI (closes stored-XSS paths), meta writes are limited to admins and size-capped, slugs and usernames are validated server-side, request bodies have a size limit, and GitHub Actions are pinned to commit SHAs. Dependencies updated (hono, nodemailer, fast-xml-parser, zod). Update to 0.3.92 or later.
- 10 themes, font choice, custom colors — a 5×2 palette, your own accent colors and a phone tab bar.
- UI zoom applies immediately, and static files revalidate (
no-cache) so a new admin version shows up without a hard reload. - Station dock — drawers are hexagons whose fill level shows how much is in them; the outline turns on hover.
- Settings in sections — You, General, Content, Publishing and System, two balanced columns, collapsible cards (state is remembered), a jump bar and Expand/Collapse all. The page is less than half as long.
Oct 2026 · admin@0.3.88 · core@0.3.21 · mcp@0.1.5 · integration@0.3.22 · client@0.1.4 · cli@0.3.15 — Two-factor sign-in, signed webhooks, key limits, version diff and media usage
- 2FA (TOTP) — turn it on under Account with any authenticator app. Eight one-time recovery codes, codes can't be replayed, and an admin can reset a locked-out user. Docs →
- Active sessions — see every signed-in device (browser, IP, time) and sign out one or all others.
- API key limits — restrict a key to collections, give it an expiry date or a requests-per-minute limit. Applies to the REST API and MCP. A new dialog replaces the prompt chain.
- Editor layout — custom fields now live in a collapsible “Details” card in the main column (grouped, two per row, long inputs full width; remembers open/closed per collection) instead of small boxes in the sidebar, so the body stays the main content. Collections without a body field drop the block-editing tools. Also fixed: validation errors on publish were never shown, the long dock popups in Station mode (many collections / tools) now scroll instead of running off the screen, and the Schema page can be scrolled in Station mode again.
- Webhook recipes — tested receiver plus copy-paste handlers: Slack/Telegram on review, IndexNow, Cloudflare purge, Mastodon. Docs →
- AI translation of missing locales — one click in the editor creates the missing language versions as drafts (never overwrites, never publishes). Docs →
- Image variants + focal point —
/orbiter/media/<id>?w=800&fmt=webp&ar=16:9serves a resized, re-encoded or cropped version; crops keep the focal point you set in the media library. Bounded and cached. Docs → - Review workflow — optional. Editors submit entries for review; admins and the new reviewer role approve or request changes. Enforced on every publishing route. Docs →
- Preview links — the editor's Preview button now uses a one-hour token bound to that entry instead of the master preview token (which also fixes previews for editors, who only got a masked token before).
- Version diff — see field by field what a restore would change. Restoring now keeps the content it replaces, so a restore can be undone (previously the replaced content was lost, and the newest snapshot couldn't be restored at all).
- Media usage — each file shows where it is used; filter Unused files and Broken refs; deleting a file that is in use warns first.
- Signed webhooks — HMAC-SHA256 signatures, retries (5 s, 30 s, 5 min) and a delivery log, managed in Settings. Webhook URLs are now admin-only (editors could previously set them). Docs →
Oct 2026 · admin@0.3.87 · core@0.3.20 · mcp@0.1.4 · cli@0.3.14 — Security check, encrypted secrets, draft-only agent keys, Terminal theme
orbiter doctor+ dashboard card — flags a pod tracked by git, plaintext credentials, an open Content API and more, with the fix next to each finding. Docs →- Encrypted secrets — set
ORBITER_SECRETand stored FTP/SMTP/AI/GitHub/S3 credentials are encrypted at rest (AES-256-GCM). Opt-in; nothing changes without it. - Draft-only keys for agents — an API key can be allowed to create and edit drafts over MCP. It can never publish or touch live entries.
- Terminal theme — a fourth palette: amber phosphor on near-black, with a warm paper light variant.
- Admin polish — Settings style cards show their active state, the style default matches the app, leaving the XFCE dock reloads cleanly, visible keyboard focus, and reduced-motion support.
Oct 2026 · admin@0.3.86 · core@0.3.19 · integration@0.3.21 · mcp@0.1.3 — Security follow-up: uploaded files, URL imports, login limits, and what gets pushed to GitHub
- GitHub push no longer ships secrets — the GitHub push feature committed the whole
.pod, including live session tokens, password hashes and stored credentials (FTP, SMTP, AI and GitHub tokens). It now pushes a scrubbed copy. If you pushed before, rotate those credentials and check your repo history. - Uploaded files can't run script — media is served with
nosniffand a sandboxing CSP, and anything that isn't an image, video, audio or PDF is forced to download. Applies to the admin and the public/orbiter/mediaroute. - Server-side request forgery — importing or linking media by URL could be pointed at internal addresses (localhost, private networks, cloud metadata). Private and reserved targets are now blocked, redirects re-checked, downloads capped at 50 MB. Set
ORBITER_ALLOW_PRIVATE_FETCH=1if you need to import from your LAN in development. - Login rate limit — it trusted a client-supplied
X-Forwarded-Forheader, so it could be bypassed. The header is now only honoured when the connection comes from a reverse proxy on a private address. - Restricted editors — AI suggestions, the collection list/detail,
/api/infoand the quality report no longer expose collections an editor isn't allowed to see. Form-builder configs are admin-only. - Content API drafts — with the API enabled but no token set,
?status=drafton/orbiter/api/[collection]returned unpublished entries to anyone. Drafts now require a configured, matching token. - API token hashed — the optional single
api.tokenis now stored as a SHA-256 hash like API keys (existing plaintext values keep working and migrate on first use). - Desktop app — the embedded server only listens on loopback (it was reachable from your LAN), the window is sandboxed, only http(s) links are handed to the OS, and navigation away from the local admin is blocked.
- Smaller fixes — CSV export works again and neutralises spreadsheet formulas, the login no longer reveals which usernames exist through timing, WordPress media import is covered by the same SSRF protection, and
/healthno longer exposes the pod path. - Sessions and public endpoints — changing a password signs out all other sessions. The public form and analytics endpoints are rate-limited and size-capped, and notification mails are capped. The Content API token is compared in constant time.
Oct 2026 · admin@0.3.85 · core@0.3.18 · mcp@0.1.2 · client@0.1.3 · integration@0.3.20 · cli@0.3.13 — Security hardening pass: 3 privately-disclosed bugs fixed, full-repo audit, 0 known dependency vulnerabilities
- Stored XSS — unescaped field names/IPs in the Inbox, unescaped media filenames and analytics paths from fully unauthenticated endpoints, and the same pattern in
apps/demo's public post/page/event pages. Fixed with consistent escaping (and DOMPurify on the demo frontend) everywhere user- or visitor-supplied text reachesinnerHTML. - Collection permission bypass — an editor restricted to specific collections could still reach draft content via the singleton endpoint, the terminal CSV/JSON export, search/calendar widgets, comments, and edit-locks. All now enforce the same
requireCollectionAccesscheck as the main entry routes. See the new permissions docs. - Path traversal — the local media backend's
folderparameter could write outside the configured media directory; the GitHub and S3 backends had the same unvalidated join. All three now resolve and reject anything that would escape the configured root. - Plaintext API keys — Bearer tokens for the Public Content API and MCP server were stored and compared in plaintext, inside a
.podfile that Orbiter's ownorbiter inittemplate commits to git by design. Now hashed (SHA-256, constant-time compare), with transparent migration for already-issued keys. - Missing/inverted access checks —
api-keysmanagement, schema field rename/delete, and the embeddable-widget endpoint (/api/widget/:collection— inverted logic made it allow-by-default instead of deny-by-default like every other API gate) each had a broken or missing permission check. All fixed. - Dependency audit —
npm auditwent from 40 vulnerabilities to 0: removed an unused, outdatedelectron-builderdevDependency pulling in most of them on its own, bumped nodemailer/sharp/adm-zip/electron to patched versions, and — the big one — Astro 5 → 7 and @astrojs/node 9 → 11 acrossapps/demo,apps/landing, and theorbiter initscaffold template, closing a critical RCE in Astro's AVIF image optimization. - Process — new SECURITY.md, GitHub private vulnerability reporting and Dependabot security updates turned on for the repo, and a weekly
npm auditCI check.
Aug 2026 · mcp@0.1.0 · admin@0.3.81 — MCP server for AI agents, Public Content API, JSON-LD, API keys
@a83/orbiter-mcp— new MCP server package.list_collections,get_entries,get_entry,search_contenttools for Claude Desktop and other MCP clients. stdio for local trusted access,--httpfor remote (same auth as the Public Content API).- Public Content API —
/api/public/[collection]read-only JSON endpoints, opt-in per collection, CORS enabled. - API keys — generate/revoke Bearer tokens in Settings, optional enforcement on the Public Content API and MCP HTTP transport, hit counters and last-used tracking.
- JSON-LD / schema.org —
BlogPostingandWebSitestructured data on published HTML, both themes. - OpenAPI spec + API discovery — auto-generated spec and a discovery endpoint listing available collections and auth requirements.
- Admin panel routing fix — clean extensionless URLs (
/login,/dashboard, etc.) now redirect correctly.
June 2026 · admin@0.3.80 / integration@0.3.18 / cli@0.3.10 — Public Content API, JSON-LD, API Keys, Agent Analytics
Public Content API
GET /api/public— discovery endpoint: lists all publicly accessible collections with entry counts, auth mode, and links to OpenAPI spec and/llms.txtGET /api/public/[collection]— unauthenticated paginated list of published entries (?limit,?offset,?qkeyword search). Returns clean JSON: slug, title, excerpt, date, author, image, tags, url.GET /api/public/[collection]/[slug]— single entry with full body content and SEO fieldsGET /api/public/openapi.json— auto-generated OpenAPI 3.1 spec derived from pod schema. Per-collection paths, query parameter docs, Bearer auth scheme if API keys are required.- Per-collection opt-in via Settings → Public API collections (
posts, pagesor*for all). Wide CORS — fetch from any origin.
API Keys
- Generate named API keys in Settings → API Keys — shown once at creation, then masked
- Optional enforcement: toggle Require API key in Settings to require
Authorization: Bearer <key>on all/api/public/requests - Hit counter and last-used date per key, tracked on every request
- Revoke individual keys from the Settings UI
JSON-LD / schema.org
- Published HTML sites (both Orbit and Canvas themes) now include
<script type="application/ld+json">in every page - Entry pages:
BlogPosting— headline, description, datePublished, dateModified, author (Person or Organization), image, keywords, publisher - Index and collection pages:
WebSite— name, url, description
Agent Analytics
- New
/api/analytics/agent-trendendpoint: daily human vs. agent traffic split + top pages by agent hits - Analytics page now shows Agent Traffic section (below the bottom grid) with: human/agent split bar with percentages, stacked daily trend minichart, top agent pages table
- Section only appears when actual bot traffic exists in the database
CLI: orbiter status — Public API info
- Status output now includes a Public API block: auth mode, active key count, which collections are exposed, and the endpoint + OpenAPI URLs (when
site.urlis configured)
llms.txt + llms-full.txt (integration@0.3.16)
- Standard-path
GET /llms.txt— machine-readable content index for AI agents (llmstxt.org convention). Lists all published entries with URLs and summaries, grouped by collection. GET /llms-full.txt— full body content dump for RAG pipelines. Opt-in per collection viallms.collectionsmeta key.
Content Validation
- Schema editor:
min,max,regexinputs per field (visible for string / number / url / email / richtext types) - Client: validates on publish/scheduled — shows an inline error banner in the sidebar listing all violations; drafts are always saved without validation
- Server:
validateFields()safety net in POST/PUT; returns 422 witherrors[]array when publishing/scheduling an entry that fails schema constraints
CLI: orbiter status
- New command — shows pod file size, last-published timestamp, user count, and per-collection entry counts by status (published / draft / scheduled / trashed)
- Usage:
orbiter status(reads./content.pod) ororbiter status ./path/to/content.pod
orbiter init — Content Layer scaffold
- Generated project now includes
src/content.config.tswiring up theorbiterLoaderfor the defaultpostscollection src/pages/posts/[slug].astroadded as a starter entry page- Seeds
bodyfield asrichtext(wasmarkdown)
SvelteKit Guide
- Added usage guide to README: server-side and static pre-rendering examples with
@a83/orbiter-client
Entry Templates
- Save any entry as a reusable template from the editor sidebar (name input + Save button captures title, body and all fields)
⌗button in the entries list opens a template picker — click to pre-fill the new-entry modal with all template data- Delete templates directly from the picker; stored as
templates.{collectionId}meta keys
Wikilinks
- Type
[[in any block to open a floating entry picker (recent entries shown immediately, type-ahead search across all collections) - Arrow keys + Enter to select, Escape to dismiss; picker flips above the cursor near the screen bottom
- Inserts a styled inline link chip; serialized as
[[Title|collection/slug]]in the body
Analytics
- New bottom row: Devices (mobile/tablet/desktop bar chart), Languages table, AI & Crawlers panel (GPTBot, ClaudeBot, Perplexity etc. with type badges)
- Entry title matching — Top Pages now shows the entry title above the raw path
- Page drill-down — click any page to filter all stats and the chart to that path;
✕in the header to reset - Prune button — delete analytics data older than 90 days with one click
core@0.3.12:getAnalytics()now returnsdevices(screen_w buckets) andlangsbreakdown
CLI
orbiter docs— opens the documentation in the default browser (macOS/Linux/Windows)
Editor
- Focus mode (
⌘⇧F) — hides topbar and toolbar, clean distraction-free writing surface.Escto exit. - Keyboard shortcut overlay (
⌘?) — all shortcuts at a glance, with link to docs. - Copy slug —
⧉button appears on hover next to the slug line, copies the full path to clipboard. - Reading time — word count in toolbar now shows
N w · X minalongside the existing topbar display. - Live tab title — browser tab updates as you type the entry title.
- Block drag-to-reorder —
⠿handle appears on hover on each block; drag to rearrange without cut/paste. - Entries column sort — click Title, Status, or Updated headers to sort; click again to reverse.
Media
- WebP auto-conversion — new toggle in Settings → Image optimization: JPEG and PNG uploads are auto-converted to WebP on ingest, filename updated accordingly.
Settings
- Preview URLs per collection — new section in Settings to configure the
↗ PreviewURL template per collection. Use{slug}as placeholder (e.g.http://localhost:4321/blog/{slug}).
CLI
orbiter docs— opens the Orbiter documentation in your browser.
Astro Content Layer Adapter
orbiterLoader()— build-time Content Layer loader forastro:content. UsegetCollection()andgetEntry()from the standard Astro API. Incremental digest caching, relation resolution, SEO enrichment.orbiterLiveLoader()— SSR/hybrid live loader, queries the pod at request time.orbiterSchema()— auto-generates Zod schema from pod collection definitions.- Hot Reload — file watcher on the pod triggers automatic HMR in Astro dev server.
- Backward compatible —
orbiter:collectionsvirtual module continues to work unchanged.
Publish HTML
- One-click static site generator — choose a theme, click Generate, download a ZIP. No Astro, no build tools.
- Two themes — Orbit (modern, floating island header, card layouts) and Canvas (editorial whiteboard, Cinzel serif, paper-like). Both with dark mode, responsive layout, reading time, OG tags, SVG favicon.
- Smart field detection — auto-detects title, body, excerpt, date, image, tags from any schema.
- Child collection breadcrumbs — parent→child navigation, taxonomy filtering.
Smart Suggestions v2
- Multi-section panel — tags, related entries, SEO, missing fields, quality hints shown simultaneously.
- Cross-collection — related entries found across all collections, not just the current one.
- SEO suggestions — AI-generated meta title & description.
- Content quality hints — missing image, excerpt, tags, SEO (no AI needed).
- Manual trigger —
✦ Suggestbutton in toolbar, grouped with✦ AI.
CLI
orbiter publish— generate HTML site from terminal.--pod,--out,--themeflags.orbiter backup— timestamped pod copy.--pod,--outflags.
UI Polish
- Dashboard greeting ("Good morning, admin"), live word count, pulsing autosave dot, favicon badge for unsaved changes, pod size in sidebar, collection color dots, relative timestamps, keyboard shortcut hints, skeleton loading CSS.
- Smart Suggestions — AI suggests tags, related entries, and missing field values after every save. Non-blocking banner in the editor. Auto-tags via AI, related entries via keyword overlap, missing fields with AI-generated fill values.
- Embeddable Widget SDK —
<script src="/widget.js">+<div data-orbiter="..." data-collection="posts">. Three styles: cards, list, minimal. Public API:GET /api/widget/:collectionwith wide CORS. - Knowledge Graph — interactive force-directed graph of all entries and their relationships. Canvas-based, drag nodes, pan, zoom, double-click to open.
/graph.htmlwith Tabler network icon in sidebar/dock. - Webhook event system —
webhooks.urlsmeta key (JSON array). Events: publish, delete. JSON payload with event type, timestamp, collection. Backward-compatible with existing build webhook. - User management — change role (admin↔editor), reset password per user.
PUT /api/users/:id. - Authors schema template — name, role, bio, avatar, email, website, social links, expertise, ORCID iD.
- Editor shortcuts —
⌘⇧Spublish,⌘⇧Ptoggle sidebar. - Markdown export —
↓ mdbutton exports entry as structured Markdown with grouped fields and APA7 tables. - Schema templates — "Apply template…" dropdown in schema editor (Blog, Portfolio, Business, Events, Dossier, Authors).
- Bulk AI Summarize — select entries →
✦ AI Summarizegenerates summaryMachine for each.
- Semantic Depth Fields —
depthproperty (0-3) on schema fields. Depth 0 = Narrative, 1 = Research, 2 = Evidence, 3 = Machine. Color-coded D0/D1/D2/D3 badges in the editor sidebar. Depth dropdown in the schema editor. Dossier template ships with all 28 fields depth-tagged. - llms.txt generator (
/orbiter/llms.txt) — machine-readable content map for AI agents. Lists all published entries with summaries, grouped by collection. Configurable viallms.collectionsmeta key. - JSON Feed v1.1 (
/orbiter/feed.json) — structured content feed for RAG pipelines and feed readers.?depth=0-3filters fields by semantic depth level.?collections=col1,col2filters by collection._orbiterextension with provenance data. - Agent Analytics — extended bot classification (ai-crawler, ai-agent, rag-pipeline, search, feed-reader).
GET /api/analytics/agentsendpoint with hits, top paths, last seen per agent type. - HUD-style editor sidebar — in Station mode, the meta panel becomes a slide-over panel from the right with glassmorphism backdrop. Toggle pill button "◧ Sidebar" in the toolbar. Header bar matches HUD design (accent title + close button). Full-width editor when sidebar is hidden.
- AI settings redesign — Gemini highlighted as free-tier recommended provider. "↗ Get free key" button next to API key input. Dynamic provider hints with signup links. Model field auto-clears when switching providers. Per-provider default models.
- AI gradient button — "✦ AI" pill button with accent gradient in the editor toolbar.
- Autosave indicator — visible in editor toolbar (Station mode where topbar is hidden).
- Tabler SVG icons — all dock icons replaced with Tabler Icons (inline SVGs, zero dependencies). Dashboard, Calendar, Media, Users, Inbox, Forms, Analytics, Snippets, Schema, Build, Import, Settings, Notes, To-do, Tools, HUD — all proper vector icons.
- Dynamic scheme toggle — dock button cycles Auto→Light→Dark with matching icons (sun-moon/sun/moon) and label updates.
- WCAG AA contrast compliance — all 6 themes (Space/Zen/Catppuccin × dark/light) now meet 4.5:1 minimum contrast ratio for
--mutedtext against backgrounds. Zen Dark gold/accent significantly boosted. - Space palette refined — less saturated steel-blue accent (#5088c0), desaturated teal gold/jade, warmer backgrounds in light mode. No more "baby blue".
- Dashboard typography scale — Major Third (1.25 ratio). Entry names 13px, section titles 10px, status pills 10px, dates 11px. All secondary text uses
--midinstead of--muted. - UI Zoom — slider in Settings → Appearance (85%–130%). Uses CSS
zoomproperty. Stored inlocalStorage, applied before first paint bytheme.js. - Security hardening (admin@0.3.68) —
GET /api/meta/:keyenforces ALLOWED_KEYS (was reading arbitrary keys including secrets). Secret keys masked for non-admin users. Admin-only keys require admin role for writes. Deploy, import, GitHub push routes require admin. Session cookie getssecureflag over HTTPS. - Light/dark shadow consistency — auto and explicit light mode now produce identical shadows across all styles (classic, glass, station).
- Station mode fixes — sticky settings header offset by status bar height. xfce elements hidden in classic/glass modes via CSS.
June 2026 · admin@0.3.68 — Dossier template, field groups, APA7 citations, template system, nav grouping
- Dossier POD template — new "Dossier" template alongside Blog, Portfolio, Business, Events. 39 fields in 6 groups (Content, Research, Evidence, Meta, Provenance, Agent). Demo pilot dossier included.
- Editor sidebar field groups — schema fields with
groupproperty render as collapsible sections. First two groups + APA7 groups auto-expand. - APA7 citation system — table fields with
format: 'apa7'display live-formatted citation previews (book, article, chapter, report, website). - Template import/export — export/import collections as JSON, install built-in templates into existing PODs. Additive, never destructive.
- Navigation grouping & dock drawers —
nav.hidden/nav.groupsmeta keys. Sidebar collapsible groups. Dock drawer items with hover preview cards. - Named categories — templates create
post_categories,project_categories,event_categorieswith parent/child relationships. - AI Content Assistant —
/aislash command, Ollama/Anthropic/OpenAI/Gemini support. - Keyboard navigation — 1-9 covers drawers, g-mode with dynamic collection shortcuts.
- Simple Analytics — privacy-friendly pageview tracking stored in the POD. No cookies, no fingerprinting, <500 bytes tracking script. Bot detection for GPTBot, ClaudeBot, Perplexity, etc. Admin page with daily chart, top pages, referrers, and human vs. agent traffic split.
POST/GET /api/hit(public) +GET /api/analytics(auth). Period filter: 7d/30d/90d. - OG Image picker — media picker modal in the SEO panel replaces the dropdown. Image preview + clear button. Reuses the existing media library modal.
- Dashboard widget toggles — enable/disable Calendar, Recently Edited, Collections, Notes & To-Do in Settings → Dashboard widgets. Stored in
_meta. - Keyboard navigation — added
g+k(Calendar),g+n(Inbox),g+y(Analytics),g+p(Snippets). Cheatsheet updated.
- Calendar view — new
calendar.htmlpage with full month grid. Entries are color-coded: blue = scheduled, gold = expiring, green = published, grey = draft. Click a day to see entries in the detail sidebar; filter by status. Keyboard navigation: ← → to change month, T for today. Dashboard widget shows a mini calendar + upcoming scheduled/expiring entries with a "Full calendar →" link. - Cross-pod import/export — new "Pod / JSON" tab on the Import page. Export all collections + entries as a JSON file (
GET /api/import/export-pod). Import from a.podfile or previously exported JSON (POST /api/import/pod). Creates missing collections automatically. Skip or overwrite duplicate entries. - Nodemailer security fix — updated
nodemailerfrom^8.0.10to^9.0.1to address GHSA-p6gq-j5cr-w38f (message-level raw option bypass).
- Auto-update —
electron-updaterdownloads new releases from GitHub in the background; restart dialog appears when download completes. Check manually via Hilfe → Nach Updates suchen… - Universal macOS DMG — single
Orbiter-universal.dmgruns natively on both Apple Silicon and Intel Macs (no "Intel Mac support ending" warning) - Backup — File → POD sichern… (
⌘⇧S) creates a timestamped.podcopy; dialog offers to reveal in Finder/Explorer
- File upload field (
file) — new schema field type for PDFs and documents. Drop zone in the editor sidebar, browse from the media library,entry.data.myFilereturns a media UUID. In the richtext block editor: 📎 toolbar button opens a Files tab; inserts a download block (::file[uuid|filename]). - Table field (
table) — standalone spreadsheet field in the entry sidebar. First row = header (<th>), body rows = data. Toolbar: + Row / + Col / − Row / − Col. Tab/Shift-Tab navigates between cells; Tab past the last cell adds a new row. Stored asstring[][]directly in the entry JSON — no extraJSON.parseneeded in Astro. - Image/file picker → centered modal — the media picker was a bottom sheet that could be hidden by the macOS Dock. Replaced with a centered modal (max-width 720 px, max-height 72 vh) — always visible regardless of Dock position or screen size.
- Dock hover card stats — draft count bubble removed from the dock icon. The hover preview card now shows colored chips: published (green) · drafts (amber) · scheduled (blue).
Native desktop app — no terminal, no npm, no Node.js required.
- Self-contained — Electron 42 bundles the admin server via
utilityProcess.fork(), ASAR archive - Pod picker on first launch — open an existing
.podor create a new one; choice is remembered - Templates on first launch — choose Blog, Portfolio, Business, or Events; each creates collections + demo entries so the admin is immediately populated
- Pod switching — File → POD wechseln… (
⌘O) or via the tray / system tray context menu - macOS — DMG with drag-to-Applications layout
- Windows — NSIS installer (x64); wizard with optional install directory
- Stays alive when closed — lives in the macOS menu bar tray / Windows system tray
- Standard app menu — macOS: Datei / Bearbeiten / Fenster menus,
⌘Qto quit
Form inbox — POST /api/form/:formId accepts contact and booking submissions from any Astro site. New admin page under Tools → Inbox: read, reply by email, mark as confirmed/rejected/done/spam. Honeypot spam filter. SMTP reply panel.
Built-in SEO — permanent SEO section in the entry editor (meta title, description, OG image). No schema changes needed. Live SERP preview with character counter. Available as entry.seo.title, entry.seo.description, entry.seo.ogImage in orbiter:collections.
FTP / FTPS deploy — upload Astro dist/ to shared hosting directly from the admin. Configure in Settings. Test connection button. Trigger manually or automatically after a build webhook.
Code snippets — new Tools → Snippets page with 11 copy-paste Astro snippets. Dynamically populated from your pod: collection names, admin URL, and schema. Categories: Setup, Content, SEO, Forms, Events, Integration. Keyboard shortcut g p in Space Station mode.
Packages: @a83/orbiter-admin@0.3.58.
Command palette — ⌘K or / opens full-screen. Opens pre-loaded with the 7 most recent entries. Type to fuzzy-search. Type > to enter command mode: ls, go, new, search, build, export, random, = <math>. Command history (↑/↓). Output rendered inline.
Vim keyboard navigation — press g then a letter: g d dashboard, g m media, g h HUD, g s settings, g b build, g c schema, g a account, 1–9 jump to nth dock item. Animated g › badge in status bar.
Notification center — bell in status bar. All saves, builds, and exports logged automatically. Dropdown with unread badge, timestamps, clear-all.
HUD panel expanded — Drafts section (last 10 drafts, editor links) and Activity feed (last 8 events, live on open). Toggle with g h or dock button.
Zen / focus mode (⌘⇧F) — hides dock and status bar for distraction-free writing. Persists in localStorage.
Shortcut cheatsheet (?) — two-column modal listing all shortcuts and palette commands. Also accessible via ? button in status bar.
Live build status — status bar shows ◉ building… with pulse while running, polls every 4 s until done.
Breadcrumb — status bar center shows Collection › Entries when inside a collection; clickable back.
Left dock mode — toggle dock to left sidebar. Magnification axis, popups, workspace overlay all adapt.
Hover preview cards — hovering a collection dock item shows a card (280 ms delay) with 3 recent entries + action row (new / view all / export).
Polish — active dock item ring + glow dot, Settings in dock next to Tools, min-width on dock items so labels never clip the border ring.
Packages: @a83/orbiter-admin@0.3.47.
Multilingual content (i18n)
- New
locale TEXT NOT NULL DEFAULT ''column in_entries— replaces the oldslug--localeslug suffix convention. - First locale in
site.locales(Settings → Language) maps tolocale = ''for backwards compatibility; additional locales stored as their language code. - Locale tab bar in the editor: existing variants show as solid tabs, untranslated as dashed. Click a dashed tab to create that locale variant.
- Locale filter tabs on the entries list — one tab per configured locale.
- All admin API routes accept a
?locale=query parameter (GET,POST,PUT,DELETE, restore, duplicate, status, bulk). - New endpoint:
GET /api/collections/:id/entries/:slug/locales— list all locale variants of an entry. orbiter:collectionsupdated:getCollection()andgetEntry()return default locale only;getLocaleCollection(name, loc)andgetLocaleEntry(collection, slug, loc)use the locale column with automatic fallback.- Automatic migration — existing pods gain the
localecolumn and updatedUNIQUE(collection_id, slug, locale)constraint on first start.
Space Station mode
- New layout option: floating magnification dock (macOS-style, icons scale on hover), HUD status panel (stats + scratchpad/to-do), frosted glass page headers with contextual action buttons.
- Toggle in Settings → Interface → Layout → Station.
- Mobile: dock collapses to a native-feeling bottom tab bar on screens ≤ 768 px.
- Settings page reflows into a two-column grid to reduce scrolling; Save button pinned in the glass header and repeated at the bottom.
- Packages:
@a83/orbiter-core@0.3.9,@a83/orbiter-admin@0.3.20,@a83/orbiter-integration@0.3.8.
June 2026 · v0.3.14 — Scheduled Publishing, Comments, RSS/Sitemap, Entry Locking & Email Notifications
Scheduled publishing & content expiry
- Set
publish_aton any entry to schedule it — a 60-second server-side scheduler auto-publishes at the right time and fires the build webhook. - Set
unpublish_aton published entries to automatically revert them to draft at a future date. - Both dates editable directly in the editor sidebar.
Content comments
- Per-entry editorial comment thread in the editor — post, resolve/unresolve, and delete comments.
- Comments are stored in the
_commentstable alongside the entry, never in the entry data. - API:
GET/POST /{collection}/entries/{slug}/comments,PATCH /comments/{id}/resolve,DELETE /comments/{id}.
RSS feeds & XML sitemap (integration routes, injected automatically)
GET /orbiter/rss/[collection].xml— RSS 2.0 feed for any collection. Usessite.name,site.url,site.descriptionfrom Settings.GET /orbiter/sitemap.xml— full XML sitemap across all published entries in all collections.- No configuration needed — routes are injected when you add the integration.
Schema export & import
- Export the schema of any collection as a
.jsonfile (↓ Export schema button in the edit panel). - Import a schema JSON file to repopulate the field list — useful for copying schemas between collections or pods.
CSV import & export per collection
- Export all entries of a collection as a CSV file (↓ CSV button on the entries list).
- Import entries from a CSV file (↑ CSV) — creates new entries or updates existing ones by slug.
Entry locking
- When an editor opens an entry, the server claims a lock via
POST /api/locks/{collection}/{slug}. - If another user is already editing, a yellow warning banner appears: "X is currently editing this entry."
- Lock refreshed every 60 s, expires after 90 s without a heartbeat, released on page close.
Email notifications
- Configure SMTP in Settings → Email notifications (host, port, user, pass, from, notify-to).
- Toggle "notify on publish" and "notify on comment" independently.
- Emails sent asynchronously via nodemailer — never blocks saves.
Required field validation
- Schema fields with
required: trueare validated in the editor before saving (non-autosave). - Missing required fields show a blocking alert listing the field names.
Image optimization
- Uploaded images are automatically resized (default max 2400 px) and compressed (default quality 85) via
sharp. - Configurable per-pod in Settings → Image optimization.
Build webhook
- Webhook fires automatically when an entry transitions from draft to published — no manual trigger needed
- Same URL also available via the manual Trigger build button
build.last_triggeredtimestamp updated on each fire
Pluggable media backends
blob— default, BLOB in SQLite (unchanged)local— write files to a configurable directory on the server (media.local_path)github— upload via GitHub Contents API, serve from jsDelivr CDN (cdn.jsdelivr.net/gh/...)- Configured in Settings → Media storage; stored in
_meta, no restart needed _mediaschema migrated automatically:datacolumn nullable,url+pathcolumns added
External link media
- New External link tab in the image picker — stores a URL reference without fetching any data
- Works with Dropbox, Google Drive, OneDrive, Cloudinary, any public URL
HEADrequest on save detects mime type;/orbiter/media/[id]issues a302redirect
The block editor gains full rich-media embedding:
- Inline image blocks — insert images directly into the body. Alignment controls: float left, float right, center, full width. Text wraps naturally around floated images.
- Media picker — browse the library and insert with one click, or upload from disk on the spot.
- Cloud URL import — paste a share link from Dropbox, Google Drive, or OneDrive into the image picker. The server fetches the file server-side (bypassing CORS) and stores it in the pod. Any public image URL also works.
- Video embedding — paste a YouTube, Vimeo, Wistia, or direct
.mp4/.webmURL. Video blocks render as responsive 16:9 embeds. Pasting a video URL anywhere in the editor auto-creates the block. Serialized as::video[url]in Markdown. /block picker — Image and Video entries added. Type/imgor/vidto insert.
- Three themes: Space (dark: space station HUD / light: solar command ice blue), Zen (Japandi — slate, mauve, moss), Catppuccin (Mocha / Latte). Switchable live in Settings.
- Glass layout — frosted panels, backdrop blur, animated gradient orbs. Ships as the default. Classic grid layout still available.
- Nav logo — animated SVG planet replaces emoji in the standalone admin.
- Published
@a83/orbiter-core,@a83/orbiter-integration,@a83/orbiter-admin,@a83/orbiter-clito npm. - Block-based richtext editor with live Markdown preview, autosave, version history.
- Basic locale support via
slug--localeslug convention (superseded in v0.3.20 by a dedicatedlocalecolumn). - Relation fields resolved at build time into full Entry objects.
- Multi-user auth — admin and editor roles, user management in the UI.
- WordPress WXR importer — runs in the browser, no CLI needed.
- Git sync mode —
orbiter pack/orbiter unpackfor static hosting (Netlify, Vercel, GitHub Pages). - JSON API —
GET /orbiter/api/[collection], optional Bearer token. - PWA — installable admin on mobile and desktop, service worker, offline page.
| Phase | Name | Status |
|---|---|---|
| 01 | Ignition | ✅ Done — core DB, virtual modules, basic admin |
| 02 | Bridge | ✅ Done — full admin UI, media library, auth |
| 03 | Warp | ✅ Done — block editor, version history, themes, relations |
| 04 | Orbit | ✅ Done — multi-user, CLI, PWA, npm publish |
| 05 | Station | ✅ Done — S3 backend, external media, docs site, auto-publish webhook |
| 06 | Horizon | ✅ Done — scheduled publishing, comments, RSS/sitemap, locking, email notifications |
| 07 | Cosmos | ✅ Done — Space Station mode, multilingual i18n, settings overhaul, station dock overhaul (v0.3.47) |
| 08 | Frontier | ✅ Done — CSRF protection (Origin/Referer validation + sameSite cookie) |
| 09 | Ground Control | ✅ Done — macOS desktop app, DMG installer, no terminal needed |
| 10 | Outpost | ✅ Done — Windows desktop app (NSIS installer, x64) |
| 11 | Transit | ✅ Done — runtime adapter (auto-enabled for output: 'server' / 'hybrid') |
| 12 | Launch Pad | ✅ Done — file upload field, table field, desktop auto-update, universal macOS DMG |
| 13 | Observatory | ✅ Done — calendar view, cross-pod import/export, nodemailer security fix |
| 14 | Signal | ✅ Done — Simple Analytics, OG image picker, dashboard widget toggles, keyboard nav |
| 15 | Beacon | ✅ Done — Form Builder UI, AI Content Assistant, Dossier template, template import/export, field groups, APA7 citations, nav grouping & dock drawers |
| 16 | Horizon II | ✅ Done — Dual Render: semantic depth fields, llms.txt, feed.json, agent analytics, HUD editor sidebar |
| Priority | Feature | Notes |
|---|---|---|
| 1 | Windows app menu | Test and fix menu behavior on Windows (builds work, untested on real Windows) |
| 2 | Multi-POD Dashboard | Manage multiple PODs from one desktop window |
| 3 | Dashboard Drag & Drop | Reorder widgets, custom layouts stored in POD |
| 4 | SvelteKit integration | @a83/orbiter-sveltekit — same virtual module API as the Astro integration |
Station dock overhaul — command palette with > command mode and recent entries, vim keyboard nav (g+letter), notification center, HUD drafts + activity feed, zen mode (⌘⇧F), cheatsheet (?), live build polling, breadcrumb, left dock, hover preview cards, math eval (> = expr), > random.
Multilingual (i18n) — locale column in _entries, locale tab bar in editor, ?locale= on all API routes, getLocaleCollection() / getLocaleEntry() updated in orbiter:collections. Automatic migration from slug--locale convention.
Space Station mode — floating magnification dock, HUD panel, glass page headers, settings two-column grid, mobile bottom tab bar.
Scheduled publishing & content expiry — publish_at / unpublish_at on every entry. Fires build webhook on schedule.
Content comments — per-entry editorial threads with resolve/unresolve. _comments table, full CRUD API.
RSS feeds & sitemap — /orbiter/rss/[collection].xml and /orbiter/sitemap.xml injected by the integration automatically.
Schema export/import — download schema as JSON, re-import into any collection or pod.
CSV import/export — bulk entry management per collection.
Entry locking — prevents silent overwrites when two editors open the same entry. 90-second lock with heartbeat.
Email notifications — nodemailer SMTP config in Settings, optional notify-on-publish and notify-on-comment emails.
Required field validation — blocks save (non-autosave) when required: true fields are empty.
Image optimization — sharp resize + compress on upload, configurable max-width and quality per pod.
S3-compatible media backend — R2 (Cloudflare), Backblaze B2, AWS S3, MinIO. Config via Settings → Media.
External media links — store a URL reference without fetching the file. Third tab in the image picker.
Auto-publish webhook — fires automatically on draft → published transition, not just manual trigger.
Documentation site — full reference at orbiter.sh/docs, integrated into the landing page.
orbiter.sh · MIT License · Built by Abteilung83
