Skip to content
aeon022Public

About

Self-hosted CMS in one .pod file — standalone admin, zero cloud dependencies, built for Astro. On PHP hosting: Lander.

Topics

Resources

Security policy

Stars

17 stars

Watchers

0 watching

Forks

Repository files navigation

Orbiter

Orbiter — CMS in one POD, built for Astro


npm License: MIT Astro

Portable single-file CMS for Astro — everything in one .pod file.

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

Quick Start

You need Node.js 20+ and npm 10+.

Option A — Scaffold a new project (recommended)

npx @a83/orbiter-cli init my-site
cd my-site

The 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.

Option B — Run the demo repo

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/admin

Open 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:8080

Standalone Admin (packages/admin)

The admin runs as a self-contained Hono server on port 4322 — independent from the Astro dev server. It only needs a .pod file.

Prerequisites

npm install          # run from the repo root (installs all workspaces)
npm run seed         # creates apps/demo/demo.pod if it doesn't exist yet

Start

Development (with --watch, reloads on changes to src/):

ORBITER_POD=$(pwd)/apps/demo/demo.pod npm run dev --workspace=packages/admin

Production (single run, no watch):

ORBITER_POD=$(pwd)/apps/demo/demo.pod npm start --workspace=packages/admin

Note: Use an absolute path ($(pwd)/...). The server changes its working directory internally to packages/admin/, so relative paths resolve incorrectly.

Or run directly from the package directory:

cd packages/admin
ORBITER_POD=../../apps/demo/demo.pod npm run dev

Open

http://localhost:4322

Automatically redirects to /login.html. Login:

Username: admin
Password: admin

Run both servers in parallel (Admin + Demo Site)

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.

Environment variables

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)

Test with a custom pod

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/admin

Health check

curl http://localhost:4322/health
# → { "ok": true, "pod": "/path/to/content.pod" }

Lander — Orbiter on PHP hosting

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).


Install

Admin (recommended)

The standalone admin server — runs independently, no Astro required:

npm install @a83/orbiter-admin

Astro integration

Required to read content in your Astro pages via orbiter:collections:

npm install @a83/orbiter-integration @astrojs/node@^10

@astrojs/node@^10 targets Astro 6 — use @astrojs/node@^9 for Astro 5.

Other packages

npm install @a83/orbiter-core      # direct DB access / scripting
npm install -g @a83/orbiter-cli    # orbiter init, add-user, export, pack, unpack

Desktop App

The Orbiter desktop app wraps the admin server in a native macOS and Windows application — no terminal, no npm, no Node.js required.

Install

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.

First launch — templates

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.

Switching pods

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).

Backup

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.

Auto-update

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…

Build (from source)

cd apps/desktop
npm install
npm run dev          # run in Electron without packaging

# Build universal DMG (arm64 + x64)
cd apps/desktop && electron-builder --mac

Built 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.


Setup

1. Configure Astro

// 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' })],
});

2. Create the pod and admin user

npx @a83/orbiter-cli init my-site

Or 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

3. Read content in your pages

---
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>

How It Works

The .pod file

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"

Virtual modules

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.

Admin routes

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

orbiter:collections 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"]

Entry shape

{
  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
  }
}

Media URLs

<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

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>
))}

Wikilinks

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.

Entry Templates

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.


Schema Field Types

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[]

Field definition

{
  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
}

Field notes

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]);
---

JSON API

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/posts

Response 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>"
    }
  }
]

Public Content API

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.

Enable

In Settings → Public API collections, enter a comma-separated list of collection IDs to expose, or * to expose all:

posts, pages

Discover

curl https://your-site.com/api/public

Returns the site name, auth mode, all public collections with entry counts, and links to the OpenAPI spec and llms.txt.

List entries

curl https://your-site.com/api/public/posts
curl https://your-site.com/api/public/posts?limit=10&offset=0&q=astro

Response:

{
  "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"
    }
  ]
}

Single entry

curl https://your-site.com/api/public/posts/hello-world

Returns the full entry including body (HTML), publishedAt, and seo fields.

OpenAPI spec

curl https://your-site.com/api/public/openapi.json

Auto-generated OpenAPI 3.1 spec from your live pod schema. Import into Postman, Swagger UI, or any AI tool.

API Keys (optional)

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/posts

Git Sync Mode

When to use it

Use 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.


Commands

# 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 ./media

Full workflow

Local 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 Actions template

# .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

Tradeoffs

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

WordPress Import

Import content from a WordPress WXR export directly in the admin:

  1. In WordPress: Tools → Export → All content → download the .xml file
  2. In Orbiter admin: Import → upload the WXR file
  3. Choose which post types to import
  4. 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.


Multilingual (i18n)

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 default

CLI

npm 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.pod

Using Orbiter with SvelteKit

Orbiter ships a framework-agnostic client: @a83/orbiter-client.

npm install @a83/orbiter-client

Server-side (SSR / +page.server.ts)

import { createClient } from '@a83/orbiter-client';

const orb = createClient('./content.pod');

export async function load() {
  const posts = orb.getCollection('posts');       // all published entries
  return { posts };
}

Static pre-rendering (+page.ts)

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 }));
}

Available methods

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 | null

MCP Server

Expose 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-mcp

stdio (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 4500

See packages/mcp/README.md for the full tool reference.


Admin UI

Dashboard

Entry counts per collection, recently edited entries, persistent scratchpad + todo list, build trigger status.

Entry editor

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.

Media library

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).

Schema editor

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.

Entries list

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.

Form inbox

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.

Snippets

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.

Command palette

⌘ K / Ctrl K — fuzzy search across all content and navigation from any admin page.

Themes

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.

Editor field groups

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.

APA7 citation preview

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.

Template import/export

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

Navigation grouping & dock drawers

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 Content Assistant

/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.

PWA

The admin is installable as a Progressive Web App on mobile and desktop. Service worker caches assets, offline page shown when disconnected.


Auth

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 ❌ ✅

Adapters & Deployment

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 ⚠️ Read-only Serverless FS is ephemeral — use Git sync for editing
@astrojs/vercel ⚠️ Read-only Same as Netlify
Cloudflare Workers ❌ No native Node.js support

Node.js (recommended)

npm install @astrojs/node@^9
npx astro build
node dist/server/entry.mjs

Works 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

Recommended pattern for static hosting (Netlify / Vercel)

┌─────────────────────────────┐  build hook  ┌──────────────────────┐
│  Orbiter Admin              │ ────────────▶ │  Netlify / Vercel    │
│  (VPS or Railway)           │              │  (static frontend)   │
│  /orbiter  ← edit content   │              │  /  ← visitors       │
│  content.pod  ← persists    │              └──────────────────────┘
└─────────────────────────────┘
  1. Run the Orbiter admin on a Node.js server with a persistent .pod file
  2. Edit content, click Trigger build
  3. Netlify/Vercel fetches the repo + pod, runs astro build, deploys static HTML

Build Trigger

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.


Media Backends

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

Large media libraries

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 s3 with 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).


blob (default)

No configuration. Files stored inline in the pod. Works everywhere, but pod size grows with every upload.


local

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.


github

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.


s3

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.


External link (no backend required)

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.


Repository Structure

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

Root scripts

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

Publishing

# 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=public

Release checklist:

  • All three package versions bumped
  • npm pack --dry-run is clean (no secrets, no .pod files)
  • git status is clean
  • Git tag pushed: git tag v0.x.x && git push origin v0.x.x

Adding an Admin Language

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.


Changelog

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).

Nov 2026 · admin@0.3.110 · lander@0.7.4 — Admin on phones and tablets, and a faster dock

  • 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.

Nov 2026 · admin@0.3.110 · lander@0.7.3 — A dock that glides, and pages that open without a reload

  • 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/info answer 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 needs mod_headers and mod_rewrite for 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.

Nov 2026 · lander@0.7.0 — Lander for artists: music, video, preview, quick-create

  • 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.preview and site.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.

Nov 2026 · lander@0.6.1 — Lander: the dock copes with many collections

  • "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.

Nov 2026 · lander@0.6.0 — Lander: strict Content-Security-Policy for the admin

  • Nonce on every script — the admin pages are served through PHP with a one-time nonce and a strict policy. An injected <script> or onerror= handler cannot run, the same protection Orbiter got in 0.3.98.
  • No inline handlers — all 81 onclick-style handlers moved to data-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 →

Nov 2026 · desktop@0.2.3 — Desktop app: no more admin / admin

  • 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.1 instead of localhost (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).

Nov 2026 · admin@0.3.105 · lander@0.5.6 — Security: backups are owner-only

  • 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 *.pod files 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. Set ORBITER_BACKUP_DIR to 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/.htaccess does not expose them. Lander's data/.htaccess already blocked the folder on Apache.

Nov 2026 · admin@0.3.103 · lander@0.5.5 — Autosave for every field

  • 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.

Nov 2026 · admin@0.3.102 · lander@0.5.4 — Dock: shorter German labels and your own order

  • 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 with PUT /api/meta or 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.

Nov 2026 · lander@0.5.0 · admin@0.3.100 — Digi-ID sign-in in Lander

  • 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 gmp or bcmath (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 →

Nov 2026 · admin@0.3.100 — Sign in with Digi-ID (DigiByte wallet)

  • 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 localhost or the desktop app). Legacy D… addresses.

Nov 2026 · lander@0.4.0 — Lander: webhooks and build trigger

  • 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 →

Nov 2026 · lander@0.3.3 — Lander: two-factor sign-in (TOTP)

  • 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.

Nov 2026 · admin@0.3.98 — Security: strict Content-Security-Policy enforced

  • Scripts need a nonce — the admin now blocks every script that is not part of its own pages. An injected <script> or onerror= handler in content cannot run, even if it slipped past escaping.
  • No inline handlers — all 95 onclick="…" style handlers are replaced by data-on-click attributes handled by a small dispatcher (no eval). Behaviour is unchanged.
  • Custom admin pages that still use inline handlers: switch to data-on-…, or set ORBITER_CSP=report to go back to report-only. Docs →

Nov 2026 · admin@0.3.97 · lander@0.3.2 — German admin interface

  • 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.

Nov 2026 · lander@0.3.1 — Lander: 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 zip and sodium extensions; otherwise the admin says why and you replace the files by hand. update_check => false switches it off. Docs →

Nov 2026 · lander@0.3.0 — Lander 0.3: users, installer, subfolders, backups, image sizes

  • Installer — open install.php once; 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 as redaktion.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, ?ar and ?fmt variants 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 with ORBITER_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 →

Nov 2026 · admin@0.3.95 — Backup and restore from Settings

  • 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:9 serves 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_SECRET and 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 nosniff and 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/media route.
  • 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=1 if you need to import from your LAN in development.
  • Login rate limit — it trusted a client-supplied X-Forwarded-For header, 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/info and 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=draft on /orbiter/api/[collection] returned unpublished entries to anyone. Drafts now require a configured, matching token.
  • API token hashed — the optional single api.token is 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 /health no 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 reaches innerHTML.
  • 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 requireCollectionAccess check as the main entry routes. See the new permissions docs.
  • Path traversal — the local media backend's folder parameter 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 .pod file that Orbiter's own orbiter init template commits to git by design. Now hashed (SHA-256, constant-time compare), with transparent migration for already-issued keys.
  • Missing/inverted access checks — api-keys management, 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 audit went from 40 vulnerabilities to 0: removed an unused, outdated electron-builder devDependency 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 across apps/demo, apps/landing, and the orbiter init scaffold 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 audit CI 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_content tools for Claude Desktop and other MCP clients. stdio for local trusted access, --http for 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 — BlogPosting and WebSite structured 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.txt
  • GET /api/public/[collection] — unauthenticated paginated list of published entries (?limit, ?offset, ?q keyword 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 fields
  • GET /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, pages or * 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-trend endpoint: 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.url is 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 via llms.collections meta key.

June 2026 · admin@0.3.78 / cli@0.3.9 — Content Validation, orbiter status, SvelteKit Guide

Content Validation

  • Schema editor: min, max, regex inputs 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 with errors[] 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) or orbiter status ./path/to/content.pod

orbiter init — Content Layer scaffold

  • Generated project now includes src/content.config.ts wiring up the orbiterLoader for the default posts collection
  • src/pages/posts/[slug].astro added as a starter entry page
  • Seeds body field as richtext (was markdown)

SvelteKit Guide

  • Added usage guide to README: server-side and static pre-rendering examples with @a83/orbiter-client

June 2026 · admin@0.3.77 / core@0.3.12 / cli@0.3.8 — Templates, Wikilinks, Analytics

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 returns devices (screen_w buckets) and langs breakdown

CLI

  • orbiter docs — opens the documentation in the default browser (macOS/Linux/Windows)

June 2026 · admin@0.3.76 — Editor polish, WebP, Preview URLs

Editor

  • Focus mode (⌘⇧F) — hides topbar and toolbar, clean distraction-free writing surface. Esc to 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 min alongside 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 ↗ Preview URL template per collection. Use {slug} as placeholder (e.g. http://localhost:4321/blog/{slug}).

CLI

  • orbiter docs — opens the Orbiter documentation in your browser.

June 2026 · Content Layer, Publish HTML, Smart Suggestions v2, CLI, UI Polish

Astro Content Layer Adapter

  • orbiterLoader() — build-time Content Layer loader for astro:content. Use getCollection() and getEntry() 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:collections virtual 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 — ✦ Suggest button in toolbar, grouped with ✦ AI.

CLI

  • orbiter publish — generate HTML site from terminal. --pod, --out, --theme flags.
  • orbiter backup — timestamped pod copy. --pod, --out flags.

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.

June 2026 · admin@0.3.74 — Smart Suggestions, Widgets, Graph, Webhooks

  • 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/:collection with 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.html with Tabler network icon in sidebar/dock.
  • Webhook event system — webhooks.urls meta 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 — ⌘⇧S publish, ⌘⇧P toggle sidebar.
  • Markdown export — ↓ md button 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 Summarize generates summaryMachine for each.

June 2026 · admin@0.3.70 — Dual Render Phase, HUD editor sidebar, AI settings

  • Semantic Depth Fields — depth property (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 via llms.collections meta key.
  • JSON Feed v1.1 (/orbiter/feed.json) — structured content feed for RAG pipelines and feed readers. ?depth=0-3 filters fields by semantic depth level. ?collections=col1,col2 filters by collection. _orbiter extension with provenance data.
  • Agent Analytics — extended bot classification (ai-crawler, ai-agent, rag-pipeline, search, feed-reader). GET /api/analytics/agents endpoint 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).

June 2026 · admin@0.3.69 — Tabler Icons, WCAG compliance, UI zoom, security hardening

  • 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 --muted text 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 --mid instead of --muted.
  • UI Zoom — slider in Settings → Appearance (85%–130%). Uses CSS zoom property. Stored in localStorage, applied before first paint by theme.js.
  • Security hardening (admin@0.3.68) — GET /api/meta/:key enforces 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 gets secure flag 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 group property 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.groups meta keys. Sidebar collapsible groups. Dock drawer items with hover preview cards.
  • Named categories — templates create post_categories, project_categories, event_categories with parent/child relationships.
  • AI Content Assistant — /ai slash command, Ollama/Anthropic/OpenAI/Gemini support.
  • Keyboard navigation — 1-9 covers drawers, g-mode with dynamic collection shortcuts.

June 2026 · admin@0.3.66 · Desktop v0.2.2 — Simple Analytics, OG image picker, dashboard toggles

  • 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.

June 2026 · admin@0.3.64 — Calendar view, cross-pod copy, nodemailer security fix

  • Calendar view — new calendar.html page 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 .pod file or previously exported JSON (POST /api/import/pod). Creates missing collections automatically. Skip or overwrite duplicate entries.
  • Nodemailer security fix — updated nodemailer from ^8.0.10 to ^9.0.1 to address GHSA-p6gq-j5cr-w38f (message-level raw option bypass).

June 2026 · Desktop App v0.2.0 — Auto-update, universal DMG, backup

  • Auto-update — electron-updater downloads 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.dmg runs natively on both Apple Silicon and Intel Macs (no "Intel Mac support ending" warning)
  • Backup — File → POD sichern… (⌘⇧S) creates a timestamped .pod copy; dialog offers to reveal in Finder/Explorer

June 2026 · admin@0.3.62 — File upload field, table field, image picker modal, dock stats

  • 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.myFile returns 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 as string[][] directly in the entry JSON — no extra JSON.parse needed 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).

June 2026 · Desktop App v0.1.0 — macOS + Windows installer

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 .pod or 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, ⌘Q to quit

June 2026 · v0.3.58 — Form inbox, Built-in SEO, FTP deploy & Code snippets

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.


June 2026 · v0.3.47 — Station dock overhaul

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.


June 2026 · v0.3.20 — Multilingual (i18n) & Space Station mode

Multilingual content (i18n)

  • New locale TEXT NOT NULL DEFAULT '' column in _entries — replaces the old slug--locale slug suffix convention.
  • First locale in site.locales (Settings → Language) maps to locale = '' 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:collections updated: getCollection() and getEntry() return default locale only; getLocaleCollection(name, loc) and getLocaleEntry(collection, slug, loc) use the locale column with automatic fallback.
  • Automatic migration — existing pods gain the locale column and updated UNIQUE(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_at on any entry to schedule it — a 60-second server-side scheduler auto-publishes at the right time and fires the build webhook.
  • Set unpublish_at on 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 _comments table 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. Uses site.name, site.url, site.description from 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 .json file (↓ 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: true are 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.

May 2025 — Media Backends, Build Webhook & External Links

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_triggered timestamp 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
  • _media schema migrated automatically: data column nullable, url + path columns 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
  • HEAD request on save detects mime type; /orbiter/media/[id] issues a 302 redirect

May 2025 — Editor: Images, Video & Cloud Import

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/.webm URL. 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 /img or /vid to insert.

March 2025 — Themes & Glass Layout

  • 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.

January 2025 · v0.1.0 — First npm Release

  • Published @a83/orbiter-core, @a83/orbiter-integration, @a83/orbiter-admin, @a83/orbiter-cli to npm.
  • Block-based richtext editor with live Markdown preview, autosave, version history.
  • Basic locale support via slug--locale slug convention (superseded in v0.3.20 by a dedicated locale column).
  • 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 unpack for 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.

Roadmap

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

Next up

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

v0.3.47 — released

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.

v0.3.20 — released

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.

v0.3.14 — released

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.

v0.3.1 — released

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.


Packages

Package npm Description
@a83/orbiter-core npm SQLite engine, pod management, auth utilities, media backends
@a83/orbiter-admin npm Standalone Hono admin server (port 4322), vanilla JS + CSS UI
@a83/orbiter-integration npm Astro integration, virtual modules, PWA
@a83/orbiter-cli npm orbiter init, add-user, export, pack, unpack
@a83/orbiter-mcp npm MCP server — pod content as tools for AI agents (stdio + HTTP)

orbiter.sh · MIT License · Built by Abteilung83

About

Self-hosted CMS in one .pod file — standalone admin, zero cloud dependencies, built for Astro. On PHP hosting: Lander.

Topics

Resources

Security policy

Stars

17 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages