A focused writing and multi-platform publishing tool for individual creators. Write once, adapt per platform.
- Writing desk — Markdown editing with live preview and .md import, immersive full-screen mode, manual save with best-effort save when closing or moving the page to the background, revision-aware platform variants, templates, and a media library.
- Draft library — Manage drafts, publish state, and platform variants.
- Multi-platform publishing — Publish to WeChat, Xiaohongshu, Zhihu, and X (Twitter) with progress tracking.
- Optional AI assistance — Rewrite, title suggestions, and platform adaptation; AI entry points are hidden when unconfigured.
Publio focuses on the creation and publishing loop:
Writing Desk -> Platform Variants -> Publish Checks -> Publish Progress -> Draft Library
The current app keeps only three user-facing routes:
| Route | Purpose |
|---|---|
/ |
Write, preview, manage platform variants, run checks, and publish |
/drafts |
Reopen drafts and inspect publish state |
/settings |
Configure platform credentials and AI agent settings |
git clone https://github.com/rogerdigital/publio.git
cd publio
pnpm install
pnpm devOpen http://localhost:3000. Configure platform credentials and AI agent in Settings (/settings).
Markdown editor with live preview, .md import, immersive full-screen mode, manual save with best-effort save when closing or moving the page to the background, content templates, and a media library. Platform variants track the main-draft revision, so main-draft updates do not silently overwrite manual or AI edits.
When an agent is configured, slash commands can trigger AI rewrite and title suggestions. Platform adaptation can generate variants for WeChat, Xiaohongshu, Zhihu, and X. AI responses stream to the UI; writing and publishing still work when AI is disabled.
Each platform has its own content variant that can be manually edited, synced from the main draft, or AI-adapted. Publish checks run before submission, and the progress overlay polls task status after publishing starts.
The draft library shows saved drafts, publish timestamps, publish status, and platform variant entry points. It supports reopening drafts, deleting drafts, and reviewing recent work.
The API surface covers drafts, platform variants, publishing, publish status, settings, templates, uploads, platform connection checks, and AI write/adapt/status endpoints.
See docs/configuration.md for platform credentials and AI agent setup.
Runtime data is stored in .publio-data/.
Built as a pnpm workspaces monorepo: a Vite 8 SPA frontend (apps/web, React 19 + react-router) talks to a standalone Hono 4 API server (apps/api, port 8787) over /api/*. TypeScript 5 (strict), vanilla-extract, and Zustand throughout. Shared types live in packages/shared-types.
pnpm dev # start web (3000) + api (8787) concurrently
pnpm dev:web # frontend only (Vite, port 3000)
pnpm dev:api # backend only (Hono, port 8787)
pnpm build # production build (tsc + vite build)
pnpm test # run Vitest tests
pnpm lint # ESLint
pnpm check:no-js-source # enforce TypeScript-only source rootsCI runs check:no-js-source, lint, format:check, tsc --noEmit, test, and build on every pull request to main.