Features

• Rich text editor — Tiptap-based WYSIWYG editor with a calm icon-first toolbar, reusable feature trays, selection actions, claim marking, contextual table controls, slash commands, collapsed-border tables, and drag-and-drop block reordering
• Markdown mode — toggle between rich text and raw Markdown at any time
• Editor feature trays — Insert, Review, and Outline reveal advanced blocks, readiness signals, structure tools, grammar checks, and writing analysis only when needed
• Selection actions — selected text exposes rewrite, expand, wiki-link, URL-link, and footnote actions inline
• Insert tray — one-click scaffolds, callouts, tables, data tables, Mermaid diagrams, math, decision trees, timelines, collapsibles, and live query blocks
• Contextual table lab — row, column, merge, split, header, and delete-table controls appear only while editing a table
• Editor control contract — /api/customization exposes reusable editor primitive metadata, plugin extension points, block templates, and shortcut scopes
• Slash commands — type / for Mermaid diagrams, math blocks, Excalidraw drawings, data tables, decision trees, headings, and more; includes user snippets via /snippet
• Inline AI rewrite — select text and click “AI Rewrite” in the toolbar; optionally provide an instruction; requires OPENAI_API_KEY
• Editor snippets — define reusable HTML blocks at /settings/snippets; insert via the slash-command menu
• TOC generator — toolbar button extracts all headings and inserts a linked table of contents at the cursor
• Mermaid diagrams — flowcharts, sequence diagrams, Gantt charts, and more rendered inline
• Math (KaTeX) — inline $...$ and block $$...$$ math expressions
• Excalidraw drawings — embed interactive whiteboard sketches directly in articles
• Data tables — paste CSV or JSON to create sortable, filterable tables with CSV download
• Decision trees — define yes/no trees as JSON; renders as an interactive SVG
• Pull quotes — large centred serif blockquote for emphasis; insert via /pull quote or Mod+Shift+Q
• Smart typography — auto-converts -- → em dash, ... → ellipsis, and straight quotes to curly quotes as you type
• Outline builder — AI-assisted panel generates H2/H3 section headings from the article title; supports Encyclopedic, Tutorial, and Reference styles; inserts headings directly into the editor
• AI alt-text suggestions — image caption prompt is pre-filled with an AI-suggested description derived from the filename (or heuristic if AI not configured)
• Superscript / subscript — x² / x₂ toolbar buttons for inline superscript and subscript text
• Text highlighting — 6-colour highlight picker in toolbar (yellow, green, blue, pink, orange, purple) with one-click clear
• Accordion / FAQ blocks — insert native collapsible <details> blocks via /accordion
• Two-column layout — responsive side-by-side grid block via /two-column layout
• YouTube / Vimeo embeds — paste a video URL via /youtube; auto-converts to a responsive 16:9 iframe
• Twitter / X post embeds — embed a tweet URL via /twitter; renders as a styled card with the post link
• Vertical timeline blocks — chronological timeline with date labels and dot connectors via /timeline
• GitHub Gist embeds — embed a Gist link via /github gist
• Article todo checklist — per-article task list; readers check off items, admins add and remove tasks; shows completion progress
• AI grammar & style check — Review tray disclosure analyses text for errors, warnings, and style suggestions; Apply buttons fix issues inline; falls back to heuristic checks when AI is not configured
• Footnotes & citations — inline footnote references auto-numbered via CSS counters
• Syntax highlighting — code blocks with language detection and theme-aware colours
• Voice dictation — click the microphone button to insert speech at the cursor
• Article templates — Person, Place, Event, Thing, Group templates with infobox scaffolding
• Image upload — drag-and-drop or toolbar insert; stored via Vercel Blob; optional caption displayed as styled <figcaption> below the image
• Auto-revisions — every save snapshots the previous state automatically

• Wiki links — [[Article Name]] syntax with autocomplete; broken links shown in red
• Backlinks — every article shows which other articles link to it
• Semantic relations — link articles with typed relations (is-part-of, related-to, etc.)
• Hierarchical categories — tree-structured categories in the sidebar; each article belongs to one; optional banner image per category; follow a category with the “Watch” button to track new articles
• Hierarchical tags — many-to-many; browse all at /tags with a size-scaled tag cloud
• Workspaces — Wiki is the workspace boundary for bootstrap profiles, visibility, default roles, invitations, settings, marketplace selections, and scoped article/search/category/tag APIs
• Role templates — personal admin, team owner, docs maintainer, editor, reviewer, contributor, viewer, and public reader templates define permission defaults across pages, APIs, exports, webhooks, plugins, customization, and marketplace actions
• Collaboration controls — co-authors, edit locks, review assignments, comments, mentions, notifications, workspace digests, and contribution summaries follow workspace-aware policies
• Collaboration UX — live editing exposes presence names, connection/reconnect/offline states, conflict warnings, last-saved indicators, notification routing metadata, mobile editor QA, and accessibility checkpoints
• Editorial governance — review due dates, required reviewers, approval thresholds, change-request cycles, claim queues, verification expiry, and owner gaps feed release-blocker risk summaries
• Redirects — set a “Redirect to” slug to forward old URLs automatically
• Disambiguation — notice on articles with ambiguous titles
• Article status — Draft, Review, Published; non-published articles hidden from non-admins
• Password-protected articles — set an optional access password; non-admin readers see a password gate that unlocks for the session
• Pinned articles — pin important articles to the top of category pages
• Custom metadata schemas — define typed fields (text, number, date, boolean, select) per category at /admin/metadata-schemas
• Concept maps — visual relationship graph per category at /categories/[slug]/concept-map
• Article graph — D3 force-directed graph of all wiki-link connections at /graph
• Tag synonyms — define alternate aliases per tag (e.g. “JS” → “JavaScript”) at /api/tags/[id]/synonyms

• Full-text search — AND-logic multi-word search with relevance v2 ranking, facets, synonym/stemming expansion, stale/review/verification signals, and admin explain mode
• Search API contract — /api/search/contract publishes typed result shapes for articles, categories, tags, discussions, revisions, and marketplace items plus privacy, retention, and webhook planning metadata
• Unified search surfaces — header search, the search page, command palette, wiki-link autocomplete, split view pickers, and edit fallback all consume the same search result contract
• Responsive app shell — desktop, tablet, and phone layouts use a top-left three-line main menu; larger screens can collapse the dockable sidebar into a full-width reading shell, while phones keep a safe-area-aware bottom nav for Home, Search, Create, and Recent; focused workspace pages still protect full-height canvases and composers from bottom chrome
• Full-width workspace canvas — the global shell no longer caps every page at a narrow max width, so Studio, dashboards, tables, and dense grids can use the available horizontal space without a large right-side gutter
• Main page front page — / combines live wiki stats, featured content, browse directory links, recent updates, and compact sidebar modules as the canonical wiki entry point
• Shared page headers — browse, discovery, reference, and personal pages use the same responsive header/dek/action structure so downstream pages wrap consistently
• Brand mark and compact search — the preliminary Arkivel mark appears in the sidebar/mobile header, while global search opens from a compact trigger so the top bar stays calm
• Arkivel Studio — /studio turns articles, links, review pressure, base-style lanes, and JSON Canvas export into a live workspace for visual knowledge work
• Canon Atlas — /atlas turns the wiki into a live map with category territories, article signals, story threads, a flagship dossier, continuity pressure, atlas moves, and a JSON feed
• Canon Trails — /trails turns live wiki links, backlinks, categories, freshness, depth, and engagement into guided reading routes for canon, recent work, deep pages, and repair paths
• Knowledge Command Center — /intelligence runs 20 live engines for mission readiness, editorial pressure, graph health, broken links, stubs, taxonomy debt, featured canon, translation surface, reader demand, verification debt, and cleanup flags, then opens with a live article constellation, readiness radar, and impact simulator
• Command palette navigation — Cmd+K / Ctrl+K opens grouped destinations across navigation, discovery, personal, reference, and admin surfaces
• Discovery engines — /api/discovery reports duplicate pages, unresolved questions, canon conflicts, glossary gaps, orphan topics, topic clusters, continue-reading modules, admin actions, and dashboard widgets
• Word-count search filter — advanced search includes min/max word count range to find articles by length
• Search analytics — every query is logged; admin page at /admin/search-analytics shows daily volume, top queries, and zero-result queries to find content gaps
• 30-day view sparkline — article stats panel shows a mini bar chart of daily page views for the past 30 days
• Article freshness badge — colour-coded badge (Fresh/Recent/Aging/Stale) next to the “Last edited” date on every article
• Reading streak — consecutive days a user has read articles; shown as a dashboard widget
• Federated search — fans out to peer wiki instances and merges results under “Results from other wikis”
• Explore mode — guided walk through articles using semantic similarity at /explore
• Random article — /random jumps to a random published article
• Recent changes — timeline of all edits grouped by date at /recent-changes
• Activity feed — stream of recent contributions at /activity
• Timeline view — chronological view of articles at /timeline
• Smart collections — saved searches with filters (tags, category, author, date range) at /collections
• Bookmarks — save articles with optional notes at /bookmarks
• Reading lists — ordered sequences of articles, shareable via link at /reading-lists
• TIL (Today I Learned) — post short (280-char) notes at /til
• Scratchpad — persistent personal scratch space at /scratchpad
• Session reading trail — breadcrumb of your current session's navigation at the bottom of each article
• Reading history — browser-local log of the last 50 articles you visited, with relative timestamps; accessible at /history
• Last-visit badge — article header shows “You read this X ago” on return visits without any server call
• Sticky article header — slim floating bar with article title, Edit and Top links appears after scrolling past the article title
• Table of contents — auto-generated for articles with multiple headings
• Popularity leaderboard — /popular ranks published articles by reads × 2 + reactions
• Article comparison — side-by-side view of two live articles at /compare?a=slug1&b=slug2
• “You might also like” — sidebar widget on article pages suggesting up to 5 articles sharing the same tags
• Contributor leaderboard — /leaderboard ranks users by total revision count
• Discussion index — /discussions lists all open threads across every article
• Activity heat map — GitHub-style contribution calendar on /activity showing daily edit count over the past 52 weeks
• Wiki stats page — public /stats shows total articles, words, categories, tags, contributors, revisions, and a top-contributors leaderboard
• Mentions feed — /mentions lists all discussions that mention @username for the logged-in user
• Article Q&A — collapsible panel at the bottom of each article; ask any question and get an answer grounded in wiki content with cited sources
• Edit suggestions — readers can click “Suggest edit” on any article to propose a correction; admins review, comment, assign, convert, accept, or reject at /admin/suggestions
• Reader retention analytics — scroll depth distribution per article at /admin/retention
• Referrer tracking — incoming traffic sources tracked per article per day; aggregated view at /admin/referrers
• Satisfaction star rating — 1–5 star widget on every article page; per-session upsert; average and count shown in real time
• Hot articles widget — “Trending this week” panel on the homepage sidebar showing the top-5 most-viewed articles in the last 7 days
• Scroll position memory — article scroll position saved to browser storage; restored automatically on return visits

• Article hero header — title, category, excerpt, freshness, verification, reading metrics, return-visit badge, and co-authors are grouped into a single scannable header
• Grouped action panel — Navigate, Workflow, Collect, and Share stay in a slim action rail, while dense Read and Tools controls open from disclosure menus
• Taxonomy footer — category and tags render as wrapping chips at the end of the article rather than pipe-separated text
• Responsive article shell — article tabs, infoboxes, collapsed article tables, table of contents, backlinks, and action groups wrap or scroll intentionally on narrow screens
• Reading time estimator — “~X min read” computed at 200 wpm displayed in every article's metadata line
• Draft share links — admins generate a secret-token URL (/share/[token]) so non-admins can preview a draft without publishing
• Expiry warning banner — yellow inline banner when an article's reviewDueAt is within 30 days
• Mark as verified — admin button stamps lastVerifiedAt; date shown as a ✓ badge in the article byline
• Article series navigation — prev/next links between articles belonging to a series
• Series table of contents — collapsible panel on article pages listing all entries in the series with read indicators and current article highlighted
• See also — curated links to related articles, managed by admins
• Changelog panel — collapsible list of the last 5 edits with authors and diff links
• Word goal progress — progress bar shown until the article reaches its target word count
• Floating table of contents — sticky sidebar TOC with active-section highlighting on wide screens (≥1280 px)
• Article stats panel — collapsible panel showing reads, reactions, word count, quality score, and article age
• Article flags — admin-assigned labels (e.g. “Needs images”, “Outdated”) displayed as orange badge chips near the title
• Article co-authors — link additional contributors to an article; co-author names appear in the byline
• Named snapshots — manually save a labeled snapshot of any article beyond the automatic revisions
• Reading mode — distraction-free reading toggle; hides header and sidebar, widens content; press R or the toolbar button to toggle
• Cover image focal point — click to set a focal point on the cover image so cropped displays always center on the subject
• Duplicate article — admin toolbar button clones any article as a new draft, preserving all content, tags, and category
• Print stylesheet — press Ctrl+P / Cmd+P for a clean print view: all chrome hidden, full-width content, external link URLs appended
• Reading level badge — Flesch Reading Ease score computed from article text and shown as a colour-coded badge (Very Easy → Very Complex)
• Glossary hover cards — defined terms in article text are underlined with a dotted accent; hovering shows a floating definition card
• In Brief summary — when an article has a short summary, it is displayed as a highlighted callout at the top of the content
• Heading permalink links — hovering over any heading reveals a ¶ link that copies the anchor URL to the clipboard

A personalizable homepage at /dashboard with a draggable widget grid.

• Available widgets: Recent articles, Watchlist, Recent edits, Random article, Scratchpad preview, Wiki stats, Notifications
• Toggle widgets on/off and reorder via “Customize” mode
• Layout saved to your user preferences and restored on next visit

• Learning paths — curated ordered sequences of articles with per-path progress tracking at /learning-paths
• Flashcards — create decks from articles; SM-2 spaced repetition with 0–5 grading at /flashcards
• AI quizzes — Claude generates 5 multiple-choice questions from any article for self-testing
• AI Tutor Mode — Socratic AI tutor chat on any article; asks probing questions and tests comprehension
• Spaced repetition review queue — enroll articles; SM-2 algorithm schedules daily reviews at /review
• Daily digest — personalised in-app briefing at /digest: due reviews, watched updates, AI facts, article of the day
• Adaptive reading level — switch any article to Beginner, Technical, or ELI5 view on the fly via AI
• Article audio narration — listen button on every article uses browser TTS to narrate the full text
• Reading progress — mark articles as read; category pages show a completion ring
• Presentation mode — any article opens as a full-screen slideshow at /present/[slug]; each H2/H3 is a slide, and long content scrolls within the slide stage rather than covering controls
• Watchlist digest — optional daily email summary of watched article changes at /watchlist/digest

• Real-time co-editing — simultaneous editing with cursor presence, named participant indicators, connection states, conflict warnings, reconnect states, and last-saved copy via Yjs/y-prosemirror
• Discussions — threaded comments on every article; @mention triggers notifications, and admins can moderate reported, hidden, removed, or reviewer-only threads
• Article reactions — Helpful, Insightful, Outdated, Confusing via the reaction bar
• Change requests — propose edits without direct write access at /change-requests
• Article forks — propose a full rewrite; admins review/merge/reject at /forks
• Review requests — request review from an article, assign or self-assign reviewers, discuss the draft in /reviews, approve to publish, request changes, reject, or resubmit
• Claim Review Mode — marked claims keep persistent review states on the article page. Editors can approve, request a source, dispute, reject, or leave notes for each claim
• Knowledge bounties — request new articles; contributors claim and fulfil them at /bounties
• Expert badges — admin-granted per category; highlighted in revision history and bylines
• Article certification — “Verified by experts” badge after review by 2+ experts
• Contributor achievements — First edit, 10/100 edits, streak badges, category expert; unlocked with toast notification

AI features degrade gracefully when API keys are absent.

• Assistant packs — /api/assistant-packs, /admin/assistants, and docs/assistant-packs.md expose opt-in drafting, summarization, search, claim extraction, taxonomy, alt-text, import cleanup, and review packs with per-space availability, prompt/context previews, usage/cost metadata, permissions, safety, and fallback metadata
• Assistant governance — /api/assistant-packs/governance and docs/assistant-governance.md publish privacy warnings, human-review requirements, citation prompts, confidence metadata, AI audit events, private/sensitive opt-outs, and the optional/non-blocking release gate
• Writing coach — Review tray disclosure with Flesch-Kincaid score, passive-voice count, sentence-length stats, and AI suggestions
• Article summaries — auto-generated on save; used as the page meta description
• Semantic search — vector embeddings via OpenAI blend meaning-based results with keyword matches
• Duplicate detection — warns when a new article is semantically similar to an existing one
• Knowledge gaps — surfaces referenced-but-uncreated topics at /admin/knowledge-gaps
• Category suggestions — Claude suggests topics missing from a category
• Quiz generation — 5 multiple-choice questions generated per article by Claude
• Translation — machine-translate articles via DeepL or Google Translate (requires API key)
• AI auto-fill — type a title on the new article page and pick a template type; AI generates a full structured draft
• Category overview generator — button on category pages generates AI-written introductory prose from all articles
• AI fact-check — analyzes 3–6 factual claims per article; rates each as Verified / Plausible / Uncertain / Questionable
• Smart editor suggestions — live sidebar detects unlinked wiki articles, related pages, and AI-suggested missing sections
• AI revision summary — automatically generates an edit summary when saving changes
• Import from URL / Image / YouTube — AI converts web pages, photos of notes, and video transcripts into wiki articles

Standalone Excalidraw canvases at /whiteboards — separate from article-embedded drawings.

• Create unlimited named canvases; auto-save to the database 2 seconds after each change
• Edit titles inline; full Excalidraw toolkit (shapes, text, arrows, images)
• Embed any whiteboard in an article via the Excalidraw slash command

Capture content from the web directly into the wiki without switching context.

• Browser extension — Manifest V3 Chrome/Edge/Brave extension; popup pre-fills title and selected text, lets you set category, saves as draft via the API. Install guide at /clipper-extension.
• Bookmarklet — drag-to-install JavaScript bookmark; clips any page URL + title (or selected text) as a draft article. Install at /bookmarklet.
• Selected text is wrapped in a blockquote with a source link; page HTML has nav/scripts stripped automatically

Import

• File upload — drag-and-drop .md, .txt, .html, or .json at /import
• Obsidian vault — upload a .zip; front matter and [[wikilinks]] resolved automatically
• Notion — connect integration token and import a page tree
• Confluence — paste or upload a Confluence HTML export; title and content extracted, macros stripped

Export

• PDF (browser print), Markdown (.md), ePub 3, Word (.docx) — per article via the Export ▾ menu
• Category export — entire category as multi-chapter ePub or zip from the admin area
• Bulk ZIP export — download the entire wiki (or a single category) as a .zip of Markdown files, one per article, organised in category subfolders with YAML front-matter

• REST API v1 — /api/v1/ with X-API-Key auth, frozen contract metadata at /api/v1/contract, OpenAPI JSON at /api/v1/openapi.json, standard v1 headers, fixture responses, and a pre-v5 migration guide. See API Documentation.
• SDK types — /api/v1/sdk and docs/sdk-types.md publish REST payload, webhook event, customization, marketplace pack, plugin manifest, export bundle, API key scope, generated client example, and sample script metadata.
• Webhook reliability — timestamped signatures, retry metadata, delivery logs, redelivery, event schemas, replay protection, admin test sender, and local receiver docs.
• Operations dashboard — /admin/operations and /api/admin/operations?bundle=1 expose admin-only service health, queue health, slow pages, failed webhooks/imports/exports/plugins, alerts, acknowledgements, and redacted support bundles.
• Maintenance tooling — /admin/maintenance and /api/admin/maintenance/report expose safe-upgrade checks, backup reminders, background task pausing, cleanup queues, and runbook metadata.
• Observability — /admin/observability, /api/admin/observability, and /api/observability/metrics expose structured events, metric ingestion, privacy controls, and external collector guidance.
• Performance budgets — /admin/performance and /api/admin/performance expose route p95, interaction, and bundle budgets, large-wiki fixtures, slow samples, and slow-query diagnostics.
• Cache strategy — /admin/cache and /api/admin/cache expose cache invalidation rules, manual invalidation, stale warnings, Redis status, and deployment recipes.
• Offline/PWA — /api/offline/contract, /sw.js, and /offline.html define install prompts, offline reading caches, stale indicators, retry queues, mobile QA, draft warnings, and privacy limits.
• Mobile polish — /api/mobile-polish and docs/mobile-polish.md define responsive QA, 44px touch targets, safe-area checks, overflow/clipping guardrails, dialog bounds, and mobile help screenshot slots.
• Desktop research — /api/desktop-research and docs/desktop-app-research.md compare Electron, Tauri, browser PWA, and Docker Desktop options without committing desktop packaging to v5 scope.
• Accessibility finish — /api/accessibility and docs/accessibility.md define keyboard/focus/dialog/dropdown/control audits, widget summaries, contrast/motion checks, and v5 accessibility blockers.
• Security review — /api/security/review, docs/security-review.md, and middleware headers define reviewed surfaces, abuse-case gates, supply-chain checks, and the pre-v5 threat-model draft.
• Privacy controls — /api/privacy/controls and docs/privacy-controls.md define deployment-mode controls, retention settings, user export/deletion planning, and AI/external integration warnings.
• Marketplace security — /api/marketplace/security and docs/secure-marketplace-plugins.md define unsafe pack rejection, blocked permissions/hooks, dangerous plugin capability warnings, provenance checks, and local-only installation guidance.
• Marketplace beta — /api/marketplace/beta and docs/marketplace-beta.md publish beta metrics, featured/recent/recommended packs, collections, compatibility badges, search facets, install-intent steps, and limitations.
• Marketplace lifecycle — /api/marketplace/lifecycle and docs/marketplace-lifecycle.md define pack states, transitions, inventory, health checks, preview media validation, update metadata, compatibility warnings, and rollback guidance.
• Marketplace authoring — /api/marketplace/authoring and docs/marketplace-authoring.md define pack author dashboard metadata, README generator/checklist output, Arkivel compatibility matrix rows, author quality expectations, and submission templates.
• Template marketplace — /api/marketplace/templates and docs/template-marketplace.md define template-pack listings, included schema, category and article previews, compatibility notes, diff/merge contracts, and export-from-space fixture output.
• Sync manifests — /api/sync-manifests and docs/sync-manifests.md define source/target manifests, checksums, dry-run reports, signed snapshot plans, staging promotion checks, and the network-federation release gate.
• External references — /api/external-references and docs/external-references.md define imported/mirrored provenance, diagnostics, and public index planning that excludes private content.
• Archive mirrors — /api/archive-mirrors and docs/archive-mirror-workflows.md define read-only archive snapshots, private mirror setup, selected-space transfers, repeated-sync conflict notes, and the pre-v5 federation decision checkpoint.
• Migration readiness — /api/migration-readiness and docs/migration-readiness.md define blocking migration dry runs, backup prompts, schema compatibility reports, restore validation, representative v4 upgrade paths, and failure recovery guidance.
• Backup and restore — /api/backup-restore and docs/backup-restore.md define admin backup wizard sections, restore rehearsal validation, scheduled backup planning, external storage notes, and disaster-recovery drill guidance.
• Upgrade assistant — /api/upgrade-assistant and docs/v5-upgrade-planning.md define v5 readiness checks, pre-upgrade diagnostics, post-upgrade smoke checks, compatibility warnings, and release-note/migration doc links.
• Test quality gates — /api/test-quality and docs/test-quality-gates.md define expanded test surfaces, stable QA fixtures, CI matrix planning, warning policy, and release-manager dashboard planning.
• E2E smoke suite — /api/e2e-smoke-suite, e2e/smoke-suite.spec.ts, and docs/e2e-smoke-suite.md define product smoke flows, responsive routes, fixture seeding, and failure screenshots/traces.
• Release gates — /api/release-gates, scripts/verify-docs-sync.mjs, and docs/release-gate-automation.md define release candidate gates, docs sync verification, checklist metadata, known issues, and blocker labels.
• Documentation onboarding — /api/documentation-onboarding, docs/index.md, and docs/maintainer-guide.md define maintainer docs, setup paths, troubleshooting, docs IA, and practical link-test coverage.
• In-app onboarding — /api/in-app-onboarding, docs/in-app-onboarding.md, and examples/onboarding/demo-content-pack.json define first-run setup, guided admin topics, contextual help panels, demo content, and screenshot checkpoints.
• Example site recipes — /api/example-site-recipes, docs/example-site-recipes.md, and examples/recipes/site-recipes.json define setup recipes, env snippets, screenshot targets, pack recommendations, migration stories, and v5 readiness checks.
• Feature freeze — /api/release-freeze, docs/feature-freeze.md, and docs/known-issues.md define freeze policy, rehearsal matrix, blocker labels, v5 gate ownership, and release-note draft sections.
• Release candidate one — /api/release-candidate-one, docs/release-candidate-one.md, and docs/rc-feedback-template.md define RC1 gates, deployment validation, starter/pack/import/export validation, review checklists, and feedback template.
• Final release gates — /api/final-release-gates and docs/final-release-gates.md define RC fixes, final beta freeze contracts, gate evidence, compatibility targets, correction windows, and stable v5 release gates.
• REST API v2 — pagination cursors, field selection
• GraphQL API — /api/graphql powered by graphql-yoga; includes GraphiQL playground. Queries for articles, categories, tags, revisions, search, and stats.
• Customization manifest — /api/customization exposes grouped brand, style preset, color theme, layout, feature flag, limit, map, reusable component, editor control, collaboration UX, public API v1, SDK type, webhook reliability, operations dashboard, maintenance tooling, observability, performance budgets, cache strategy, offline/PWA, mobile polish, desktop research, accessibility finish, migration readiness, backup/restore, upgrade assistant, test quality gates, e2e smoke suite, release gate automation, documentation onboarding, in-app onboarding, example site recipes, feature freeze, release candidate one, final release gates, security review, privacy controls, marketplace security, marketplace beta, marketplace lifecycle, marketplace authoring, template marketplace, sync manifest, external reference, archive mirror, component slot, persisted space customization, marketplace registry/import-preview, plugin manifest schema/examples/compatibility matrix, plugin, theme-pack, template-pack, migration guidance, and theme-hook metadata for self-hosters, plugins, forks, and deployment dashboards.
• Trusted local plugins — /admin/plugins reads registered plugins plus trusted local plugin.json manifests only when ARKIVEL_ENABLE_TRUSTED_PLUGINS=true and an absolute ARKIVEL_TRUSTED_PLUGIN_DIR are configured, then shows permissions, routes, widgets, hooks, compatibility, and load errors before enablement.
• Plugin permission review — plugin manifests show prompts, risk labels, health status, last load/error metadata, routes, widgets, hooks, version/source details, and audit-backed enable/disable events. Remote arbitrary-code loading is outside the v1 trusted-local boundary.
• Plugin starter kit — examples/plugins/starter-plugin/, docs/plugin-authoring.md, examples/plugins/marketplace-listing-template.json, and npm run plugin:validate give authors a manifest, route, widget, setting, hook, job, smoke-test checklist, compatibility notes, and validation workflow.
• Portable bundle contract — docs/portable-bundles.md defines the pre-v5 full-site bundle manifest, checksums, source metadata, export scope, sessions/API-key/analytics exclusions, privacy filters, and import dry-run report shape for conflicts, missing assets, unsupported schemas, duplicate slugs, and permission gaps.
• Export hardening — Markdown, HTML, JSON, and ZIP exports emit manifest/checksum headers and record admin export history when persistence is available. /api/export/history?download=1 downloads reports with file counts, byte counts, omitted private data, warnings, status, and scope metadata.
• Import rehearsal — /api/import/rehearsal exposes dry-run conflict categories, recommended actions, blocked changes, rollback plans, and fixture profiles for small wiki, large archive, docs portal, and worldbuilding atlas imports before any write-capable flow.
• Workspace model contract — docs/workspaces.md documents bootstrap profiles, invitation APIs, scoped API parameters, marketplace selections, and single-workspace migration.
• Role template contract — docs/role-templates.md documents role templates, API-key behavior, invitation expiration/resend/revoke actions, audit events, and admin recovery guidance.
• Private team knowledge base — docs/private-team-knowledge-base.md documents private workspace setup, collaboration routing, user preferences, and public-surface visibility rules.
• Editorial governance API — /api/admin/editorial-governance/summary reports release blockers, editorial risk, claim queues, verification renewals, and owner gaps.
• Space customization API — /api/categories/:id/customization and /api/articles/:id/customization resolve global, parent-space, space, and article overrides for style, color theme, layout, component pack, template pack, navigation, and metadata schema while hiding private draft config from public reads.
• Space customization editor — /admin/categories lets admins edit category-space overrides, inspect inherited effective values and source badges, reset to parent/global values, preview article-list/metadata/navigation/theme outcomes, review conflict warnings, and check responsive QA notes.
• Space templates — /api/space-templates exposes preview-safe personal wiki, product docs, team handbook, worldbuilding bible, research notebook, reading archive, project knowledge base, and public documentation templates, with preview pages, JSON validation, one-click local import previews, category trees, starter articles, sample metadata, tags, infobox fields, navigation, dashboards, layouts, and recommended packs.
• Domain workflows — /api/space-workflows and docs/domain-workflows.md publish workflow controls, steps, starter template links, and release gates for docs portals, team handbooks, worldbuilding, research, and personal wiki products.
• Space governance hooks — /api/categories/:id/governance persists category owner, reviewer, default visibility, review cadence, stale-page threshold, and health-signal preferences. Article pages show inherited governance badges, and the admin dashboard summarizes space health widgets for stale pages, unreviewed claims, orphaned content, and broken links.
• Component slot registry — Stable contracts cover article cards, article headers, metadata panels, infoboxes, dashboards, homepage sections, search results, editor panels, space navigation, and admin summaries with fallback, loading, error, permission, and data-boundary metadata.
• Built-in component packs — Default wiki, docs portal, team knowledge base, worldbuilding atlas, and research notebook packs declare named slot components and recommended layouts for future runtime pack loading.
• Layout composition hooks — Built-in layouts publish shell density, homepage order, article columns, right-rail behavior, dashboard modules, category landing behavior, screenshot metadata, and scoped html[data-layout="..."] hooks.
• Component-pack developer experience — Pack authors can scaffold packs, validate manifests locally, start from examples/marketplace/component-pack, and plan previews with typed article, category, dashboard, marketplace, and editor fixtures.
• Style presets — NEXT_PUBLIC_ARKIVEL_STYLE switches between the default classic-wiki skin and the alternate atlas-modern skin without changing route code.
• Color themes — NEXT_PUBLIC_ARKIVEL_COLOR_THEME switches between standard, forest, and ember palettes independently from the selected style preset.
• Layout presets — NEXT_PUBLIC_ARKIVEL_LAYOUT publishes layout intent such as classic-wiki, docs-portal, team-knowledge-base, worldbuilding-atlas, or research-notebook for preview and future shell variants.
• Customization Studio — /admin/customization is a tabbed env-first workbench for brand copy, logos, style, color theme, layout, feature flags, browser-local drafts, named presets, active-vs-draft diffs, keyboard-accessible tabs, screen-reader summaries, responsive QA checkpoints, palette/dark-theme/asset-size diagnostics, preview panels, source badges, theme-pack JSON validation, downloadable support reports, and copy-ready .env, .env.local, Vercel, or Docker Compose output.
• Built-in Marketplace — /admin/marketplace lists and filters styles, color themes, layouts, component packs, plugins, and theme packs with versioned local-registry health, schema/source metadata, detail panels, screenshots, docs links, copy-ready env vars/JSON/install notes, license/checksum details, preview-only pack import parsing, theme token diffs, validation issue reporting, and no remote code fetching.
• Marketplace contribution kit — docs/marketplace-contributions.md, examples/marketplace/, and GitHub issue templates document preview-safe pack submissions, naming/versioning rules, sample manifests, review checklists, screenshots, and validation expectations.
• RSS & Atom feeds — /feed.xml and /feed/atom
• Webhooks — HTTP callbacks dispatched on article events; delivery log at /admin/webhooks
• Embeds — iframe-safe embed tokens per article at /embed/[token]
• Slack — /wiki <query> slash command to search from Slack
• Discord — /wiki slash command in Discord
• Issue links — link GitHub, Jira, or Linear issues to articles with inline status badges
• Federated peers — configure peer wiki instances for cross-wiki search at /admin/federated-peers

Optional feature. Enable with NEXT_PUBLIC_MAP_ENABLED=true.

• Multiple maps with custom background images and named layers
• Clickable polygon areas linked to articles with hover tooltips
• Different marker detail levels per zoom tier
• Admin edit mode: draw, reshape, recolor, link to articles

• Dyslexia mode — OpenDyslexic font, increased spacing, warm background tint (persists across sessions)
• RTL toggle — switch article content to right-to-left reading direction
• Audio narration — text-to-speech via ElevenLabs (if configured) or browser synthesis; includes speed control
• Machine translation — DeepL or Google Translate (requires API key)
• Skip-to-content link — visible on keyboard focus on every page
• Keyboard shortcuts overlay — press ? anywhere to open a categorized shortcuts modal (navigation, article, editor, general)
• Keyboard shortcut customization — remap navigation chords at /settings/shortcuts; overrides saved in browser localStorage
• Article lock — editor page acquires a 10-minute lock; other users see a “Being edited by X” warning with admin force-unlock option

• Roles — Viewer (read only), Editor (create/edit), Admin (full access)
• Multi-user accounts — registration, profiles at /users/[username], settings at /settings
• Admin dashboard — review queue, statistics, embed tokens at /admin
• Announcement banner — post a site-wide notice (info/warning/success/error) with optional expiry at /admin/announcements; users can dismiss per session
• Analytics — scroll depth heatmap, navigation paths at /admin/analytics
• Performance metrics — system metrics at /admin/metrics
• Operations dashboard — service health, queues, slow pages, failed jobs, alerts, acknowledgements, and redacted bundles at /admin/operations
• Maintenance tooling — safe-upgrade checks, backup reminders, background task pausing, cleanup queues, and runbooks at /admin/maintenance
• Observability — structured operational events, metric ingestion, privacy controls, and event feed at /admin/observability
• Performance budgets — route budgets, large-wiki fixtures, slow samples, and Prisma query review guidance at /admin/performance
• Cache strategy — invalidation rules, manual invalidation, stale warnings, Redis status, and deployment recipes at /admin/cache
• Offline/PWA — install prompts, cached reading pages, stale indicators, retry queues, and mobile QA via /api/offline/contract
• Mobile polish — responsive QA, touch targets, safe areas, overflow checks, dialog bounds, and screenshot slots via /api/mobile-polish
• Accessibility finish — keyboard/focus audits, widget summaries, contrast/motion checks, and release blockers via /api/accessibility
• Security review — browser headers, review checklist, abuse cases, supply-chain gates, and threat model via /api/security/review
• Privacy controls — deployment modes, retention keys, user data lifecycle, and integration warnings via /api/privacy/controls
• Marketplace security — unsafe pack rejection, blocked hooks/permissions, dangerous warnings, and provenance checks via /api/marketplace/security
• Marketplace beta — landing metrics, featured/recent/recommended packs, collections, facets, install intent, and limitations via /api/marketplace/beta
• Marketplace lifecycle — pack states, transitions, inventory, health checks, preview media validation, and rollback guidance via /api/marketplace/lifecycle
• Marketplace authoring — pack validation, metadata preview, screenshot/license/docs checks, README generation, compatibility matrix, and submission templates via /api/marketplace/authoring
• Template marketplace — template-pack listings, previews, diff/merge metadata, and export-from-space fixture output via /api/marketplace/templates
• Sync manifests — dry-run space move reports, visibility rules, checksums, and signed snapshot plans via /api/sync-manifests
• External references — imported/mirrored provenance labels, broken-reference diagnostics, and public index privacy plans via /api/external-references
• Archive mirrors — read-only archive snapshot, private mirror, selected-space transfer, and conflict decision metadata via /api/archive-mirrors
• Health score — A–F grade for link coverage, freshness, stub %, search gaps at /admin/health
• Studio feeds — /api/studio exposes the generated Studio board, base views, graph links, and action queue, while /api/studio/canvas exports the board as JSON Canvas
• Atlas JSON feed — /api/atlas exposes territories, article signals, story threads, the flagship dossier, continuity pressure, and recommended atlas moves
• Trails JSON feed — /api/trails exposes guided reading routes, stop reasons, reading estimates, word totals, and link totals
• Intelligence JSON feed — /api/intelligence exposes the command-center score, summary, graph constellation, radar axes, pressure model, 20 engines, and next-best-work queue for dashboards or automation
• Documentation, version, and commit discipline — every user-visible, API, schema, configuration, workflow, design, or contributor-guidance change updates the matching root docs, markdown docs, in-app docs, changelog/roadmap entries, and package metadata in the same commit; release commit messages follow vX.Y.Z: imperative summary
• Content lint — broken links, missing excerpts, orphans at /admin/lint
• Stale articles — articles not updated in 180+ days at /admin/staleness
• Embeddings coverage — semantic search index per article at /admin/embeddings
• Plugins — enable/disable wiki plugins at /admin/plugins
• Webhooks — configure HTTP callbacks at /admin/webhooks
• Templates — manage reusable article templates at /admin/templates
• Theme — site-wide colour and typography at /admin/theme
• Macros — define reusable content macros at /admin/macros
• Content schedule — schedule article publishing at /admin/content-schedule
• Kanban board — manage articles as cards in a Kanban workflow at /admin/kanban
• Audit log — complete admin action log at /admin/audit-log with actor, target, workspace, severity, success, date, and redacted export controls
• Moderation contract — docs/moderation.md documents discussion reports, reviewer-only notes, suggestion queue actions, public contribution spam scoring, and rate-limit planning
• Import tools — Confluence, Notion, Obsidian import at /admin/import; bulk JSON article import (up to 500 articles per batch) with auto-create tags and category resolution
• Category merge — merge two categories at /admin/categories; all articles and sub-categories from the source are reassigned to the target, then the source is deleted
• Word-count distribution — histogram of article lengths at /admin/word-count with longest/shortest tables and average word count
• Batch operations — bulk-assign category, publish/unpublish, or delete from /articles
• Tag management — rename, recolor, and delete tags inline at /admin/tags with article count and filterable list
• Bulk tag operations — apply or remove a tag from multiple selected articles at once via the article list batch action bar
• Dead-end article finder — /admin/dead-ends lists published articles with no outgoing wiki links
• Duplicate content detector — /admin/duplicate-content shows article pairs with ≥ 55% Jaccard word similarity
• Orphan article finder — /admin/orphans lists published articles that no other article links to, grouped by category
• Offline/PWA — web app manifest and service worker enable install prompts, cached offline reading for recently opened public pages, stale indicators, and narrow retry queues for eligible article work
• External link click tracking — outbound link clicks logged per article; admin view at /admin/external-links
• Prefetch on hover — internal article links are prefetched on mouse-over for near-instant navigation
• Font size preference — S/M/L/XL reading size selector in the article toolbar; persisted to browser storage
• Focus paragraph mode — dims all non-hovered paragraphs for distraction-free reading; toggle in article toolbar, persisted
• Saved search alerts — per-saved-search notification alerts; when new articles match a saved query the user gets an in-app notification; manageable at /settings/saved-searches
• Speed reader (RSVP) — flashes one word at a time from the article; ORP pivot character highlighted in accent colour; 150/250/400/600 WPM modes; progress bar; Start/Pause/Resume controls in article toolbar
• Article blame view — paragraph-level authorship at /articles/[slug]/blame; each paragraph colour-coded by the revision that introduced it with editor name, date, and edit summary
• Article polls — admins attach polls to articles; readers vote once per session; vote counts revealed after voting or when poll is closed; admins can close, reopen, or delete polls
• Reading ETA — live ~X min left counter in the article byline that decreases as you scroll; disappears on completion
• Night reading mode — warm sepia-toned dark theme toggled via moon button in article toolbar; persisted to browser storage
• Search history — browser-local list of last 20 successful searches; shown as clickable chips on the search page when no query is entered; clearable
• High-contrast mode — pure black background with white text and yellow accents for maximum readability; toggle in article toolbar; persisted
• Text-only mode — hides all images, figures, and media from article content for distraction-free reading; toolbar toggle; persisted
• Content warning tags — admins add CW labels (spoilers, violence, mature, etc.) to articles; shown as a dismissible amber banner before article body
• Content gap analysis — admin dashboard at /admin/content-gaps shows zero-result and low-result search queries to highlight missing wiki topics
• Theme customizer — floating color-swatch button in article toolbar; HSL hue slider picks the accent color live; persisted to browser storage
• Font preference — article body defaults to Serif, with a toolbar dropdown for Serif, Sans, or Mono; persisted to browser storage
• Article quick notes — collapsible private note panel on every article page; stored only in the browser; save and delete controls
• Maintenance mode — admin toggle at /admin/maintenance displays a site-wide yellow banner when the wiki is under maintenance
• Cleanup tags — admins mark articles with attention flags (Needs Images, Needs Expansion, Needs Citations, Needs Review, Stub, Outdated); shown as orange notice on article page
• Article adoption — admins can mark articles as abandoned; article page shows a banner with a one-click adopt button for editors
• Copy as plain text — toolbar button strips all HTML and copies the article body as plain text to the clipboard
• Scheduled announcements — set a future go-live time on announcements; hidden from users until the scheduled date arrives
• Read-only mode — admin toggle at /admin/read-only; blue banner and blocks non-admin edits when active
• Revision pruning — admin tool to preview and delete old revisions beyond a configurable threshold (keep latest N per article)
• User activity log — admin view of any user's full revision history with article, edit summary, and date
• Session management — view all active sessions at /settings/sessions with device and IP; revoke individual or all other sessions
• AI tag suggestions — “AI suggest” button in article edit form automatically suggests and applies relevant existing tags
• AI category suggestions — “AI suggest” button on the category picker auto-selects the best-fit category based on article content
• AI title suggestions — “AI suggest” button on the title field returns 5 clickable alternative encyclopedic titles
• Featured article badge — admins can mark articles as Featured; a gold star badge appears in the article title area
• Auto-save indicator — article edit form auto-saves draft to localStorage after 2 s of inactivity; shows “Unsaved changes” / “Draft saved” status above the editor
• Editor reliability contract — docs/editor-troubleshooting.md covers draft recovery, snapshot restore/compare/discard, offline warnings, autosave repair, paste/embed handling, diagnostics, and large-document fixtures
• Character count — displayed alongside word count in the article byline; abbreviated for large articles
• Did-you-mean suggestions — zero-result searches suggest the closest matching article title as a clickable link
• Tag cloud — /tags/cloud shows all tags sized proportionally by article count
• Article width preference — narrow/default/full reading width toggle in article toolbar; persisted to localStorage
• Local timezone timestamps — LocalDate component renders dates in the user's browser timezone
• Category growth chart — /admin/category-growth; stacked bar chart of new articles per category per month
• Image lightbox — clicking any image in article content opens it full-size in an overlay; close with Esc or click outside; caption shown when alt text is present
• AI expand section — “AI Expand” button in editor toolbar; select a paragraph and click to expand it into more detail; replaces selection with AI-expanded prose
• Smart URL paste — pasting a plain URL in the editor auto-creates a hyperlink; selection gets the URL as its href; otherwise URL is inserted as linked text
• Typewriter scrolling mode — “Typewriter” toggle in editor toolbar; keeps cursor vertically centred while typing; persisted to localStorage
• Short-article merger suggestions — /admin/short-articles lists stubs under 100 words with suggested merge targets
• Sidebar position preference — labeled Dock left/right button in the sidebar footer swaps the desktop sidebar side, fixes matching borders, and persists to localStorage; the desktop main-menu icon separately remembers whether the sidebar is collapsed or expanded, and the sidebar starts directly with navigation instead of repeating the app brand
• Tabbed content blocks — /tabs slash command; interactive tab panels in articles; stacked for editing
• Gallery grid blocks — /gallery slash command; responsive auto-fill image grid with captions and hover zoom
• AI wiki assistant — floating chat button on every article page; context-aware Q&A over article and related wiki content; multi-turn conversation
• AI article generation from outline — “AI Generate” in editor toolbar; extracts headings and fills in encyclopedic content for each section
• Button / CTA blocks — /button slash command inserts a styled call-to-action button with configurable label, URL, and style (primary / secondary / outline)
• Divider with label blocks — /divider slash command inserts a horizontal rule with an optional centered text label
• AI revision summary — “AI summarize” button in editor next to the edit summary field; compares old vs. new content and auto-generates a concise edit summary
• Article quiz mode — “Quiz me” in the article tools bar; AI generates 5 multiple-choice questions; full flashcard UI with answer reveal, score, and attempt recording
• Ask my wiki — AI oracle — full-page conversational AI at /ask; semantic search retrieves the most relevant articles per query; answers stream token-by-token; multi-turn conversation; source attribution
• Knowledge synthesis — “Synthesize” on category pages; AI reads all articles and synthesises a comprehensive overview; preview modal; “Create as new article” one-click
• Presentation mode — every article has a “Present” button; /present/[slug] is a cinematic slideshow with reserved top/bottom chrome, a scrollable slide stage, animated transitions, slide overview, fullscreen, and dot navigation
• Bulk JSON export — /api/export/json downloads all articles as a structured JSON file (admin only)
• Per-article analytics — /articles/[slug]/analytics shows 30-day view chart, reads, reactions, and revision count (admin only)
• Series progress tracker — article series navigation shows “X of N read” based on your browser reading history
• Writing velocity — admin chart at /admin/writing-velocity shows words added per week over the last 12 weeks
• Editor zen mode — toggle above the editor hides sidebar/header/tabs and widens the editing area; press Esc to exit
• Word frequency cloud — top-40 most frequent non-stop words in an article, sized proportionally by frequency, shown at the bottom of each article
• Writing session goal — set a word-count target in the editor status bar; real-time progress bar, elapsed timer (MM:SS), and green completion state when goal is reached
• Long article suggestions — /admin/long-articles lists published articles exceeding a configurable word threshold (default 5,000) sorted by length; helps identify candidates for splitting
• Random article — /api/random redirects to a random published article; optional category filter; accessible from sidebar and category pages
• New articles feed — homepage sidebar widget showing the most recently created published articles, distinct from the “recently updated” list
• Top referrers dashboard — /admin/referrers shows top 30 referring domains with traffic percentage bars; 7/30/90-day windows
• Tag usage trends — /admin/tag-trends heat-map table showing new articles per tag per month over the last 12 months
• Analytics CSV export — /api/export/analytics downloads all published articles with read counts, reactions, revisions, and dates (admin only)
• Custom branding — name, tagline, welcome text, footer, logo, logo mark, and app icon via NEXT_PUBLIC_* environment variables