Help & Features Guide

To create a new article, click Create new article in the sidebar or navigate to /articles/new.

Each article has:

• Title — the article name, used to generate the URL slug
• Content — rich text body written in the Tiptap editor
• Category — optional, for organizing articles into groups
• Tags — optional labels for cross-cutting topics
• Excerpt — short summary shown in search results and article lists
• Status — Draft (admin-only), Review, or Published (visible to all)

The rich text editor opens as a calm writing surface with advanced tools tucked into feature trays:

• Block — paragraph, heading, quote, and code block styles
• Primary toolbar — undo/redo, bold, italic, URL links, wiki links, lists, and image upload
• More — quote, table, strikethrough, inline code, superscript, subscript, footnotes, math, TOC, find/replace, typewriter mode, AI, claims, highlight, voice, and shortcuts
• Insert tray — scaffolds, callouts, tables, data tables, diagrams, math, decision trees, timelines, collapsibles, and live query blocks
• Review tray — readiness score, document signals, quality checks, grammar/style checker, and writing coach
• Outline tray — section navigation, with the outline builder tucked into a disclosure
• Table lab — row, column, merge, split, header, and delete controls while editing a table

Slash commands: Type / anywhere in the editor to open the command palette. Commands include reusable callout, metadata table, timeline, infobox, decision log, research note, worldbuilding entry templates, Mermaid diagram, Math block, Excalidraw drawing, Data table, Decision tree, heading/list types, accordion/FAQ block, two-column layout, YouTube/Vimeo video embed, Twitter/X post embed, GitHub Gist embed, and your saved snippets via /snippet.

Feature trays: Click Insert, Review, or Outline when you need advanced tools. The editor keeps those panels closed by default so the writing canvas stays clear.

Selection actions: Selecting text opens inline actions for AI rewrite, AI expand, wiki links, URL links, and footnotes.

Markdown mode: Click the Markdown button to switch to raw markdown editing. Click Write to switch back.

Templates: When creating a new article, choose from predefined templates (Person, Place, Event, Thing, Group) that provide a starting structure with an infobox and sections.

Outline builder: Open the Outline tray to generate a structured list of section headings from the article title. Choose Encyclopedic, Tutorial, or Reference style. Click Insert into article to add the headings as editable H2/H3 nodes.

AI alt-text: When you upload an image, the caption prompt is pre-filled with a suggested description based on the filename (AI-enhanced when AI_API_KEY is configured).

Grammar & style checker: Open the Review tray and expand “Grammar & style” to check your text for issues. Click Check now to analyse; each issue shows a severity (error / warning / style) with an Apply button to fix it inline.

Beyond standard text, the editor supports specialized content blocks inserted via slash commands:

• Mermaid diagrams — write graph TD; A-->B syntax; renders as a flowchart, sequence diagram, Gantt chart, etc. on the article page
• Math (KaTeX) — inline math with $...$ and block math with $$...$$
• Excalidraw — embed an interactive whiteboard drawing; stored as JSON and rendered read-only on the article page
• Data table — paste CSV or JSON data to create a sortable, filterable table with a CSV download button
• Article table — insert a standard table when cells should read as one merged grid with collapsed borders
• Decision tree — define a yes/no tree as JSON; renders as an interactive SVG with expand/collapse

Voice dictation: Click the microphone button in the toolbar to speak — your words are inserted at the cursor using the browser's speech recognition.

Click Present in the article action bar to open the article as a slideshow. Each H2 / H3 heading becomes a new slide. Use arrow keys or click to advance. Press Esc to exit. Long slides scroll inside the slide stage so the title, progress, overview, and navigation controls stay reachable.

The compact rail below the article header keeps Navigate, Collect, and Share actions visible. Read and Tools open as disclosure menus so dense reading controls stay available without taking over the page.

• Present — open as a slideshow
• Bookmark — save to your personal bookmarks with an optional note
• + List — add to one of your reading lists
• Copy link — copy the article URL to the clipboard
• Share — native share sheet (or clipboard fallback)
• Print — clean print layout (hides navigation UI)
• Export ▾ — download as PDF, Markdown, ePub, or Word (.docx)
• Aa — toggle dyslexia-friendly font and spacing
• RTL — toggle right-to-left reading direction for the article
• Translate ▾ — machine-translate to another language (requires API key)
• S/M/L/XL — font size selector; persisted between sessions
• Focus — dims non-hovered paragraphs for distraction-free reading; persisted
• Night mode — warm sepia-toned dark theme for late-night reading; moon/sun button; persisted
• High contrast (A) — pure black/white/yellow theme for maximum readability; persisted
• Text only (T) — hides images and media from the article for distraction-free reading; persisted
• Speed read — RSVP speed-reading modal; choose 150/250/400/600 WPM; ORP pivot character highlighted; Start/Pause/Reset controls
• Font preference — dropdown to switch article body font between Serif, Sans, or Mono; Serif is the default; persisted
• Accent color — color-swatch button opens an HSL hue slider to customize the wiki accent color; persisted
• Quick note — collapsible private note panel per article; stored only in this browser; save and delete controls
• Copy plain text — button in article toolbar copies the article body as plain text (HTML stripped)

Typing syntax

• Type [[Article Name]] — auto-converts to a wiki link
• Type [[Article Name|Display Text]] — link with custom display text

Link suggester

Type [[ to open the autocomplete dropdown. Use arrow keys to navigate, Enter to select, Escape to dismiss.

Link status

Links to existing articles appear in blue. Links to missing articles appear in red— a cue to create that article.

Keyboard shortcut

Press Ctrl+Shift+L (Cmd on Mac) to insert a wiki link.

• The search bar provides instant results as you type; press Enter for the full search page
• Instant search, the full search page, command palette, wiki-link autocomplete, split view article pickers, and edit fallback all use the same search result contract
• The editor publishes reusable control metadata through /api/customization, including primitive names, plugin extension points, block templates, and shortcut scopes
• Live collaboration publishes UX metadata through /api/customization, including connection states, conflict/reconnect copy, notification routing, mobile QA, and accessibility checkpoints
• Multi-word queries use AND logic — every word must appear somewhere in the article
• Results use relevance v2 ranking across exact title, phrase, alias/redirect, word coverage, freshness, review, and verification signals
• Admins can request /api/search?q=...&explain=1 for per-result score explanations
• Plugins, widgets, dashboards, and mobile clients can read /api/search/contract for stable typed result shapes and privacy metadata
• Semantic search: set OPENAI_API_KEY to blend AI-ranked results based on meaning, not just keywords
• Federated search: when peer wikis are configured, results from other wikis appear in a separate section on the search page automatically
• Search history: your last 20 successful searches are stored in browser memory and shown as clickable chips when the search page has no active query; use the Clear button to wipe the list

AI features are gated on environment variables and degrade gracefully when 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 notes, and fallback metadata for local/offline-friendly deployments.
• 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 — disclosure inside the Review tray. Shows Flesch-Kincaid readability 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. Requires OPENAI_API_KEY.
• Knowledge gaps — /admin/knowledge-gaps lists referenced but uncreated article titles, sorted by incoming-link count.
• Duplicate detection — checks for semantically similar existing articles when creating a new one.
• Category suggestions — Claude suggests topics missing from a category.
• Quiz generation — Claude generates 5 multiple-choice questions from any article for self-testing.
• AI auto-fill — on the new article page, type a title and choose a template type (Person, Event, Place, Concept, Organization, Product); click Auto-fill to generate a full structured draft.
• Category overview generator — button on category pages; AI reads all published articles and writes a 2–4 paragraph encyclopedic introduction.
• AI fact-check — button at the bottom of any article; Claude analyzes 3–6 factual claims and rates each as Verified / Plausible / Uncertain / Questionable with a confidence bar.
• Smart editor suggestions — click Suggestions in the editor toolbar while writing; shows unlinked article mentions, related pages, and AI-generated ideas for missing sections.

• Learning Paths — curated sequences of articles. Browse at /learning-paths or create your own. Progress is tracked per path.
• Flashcards — create flashcards from any article. Review due cards at /flashcards using the SM-2 spaced repetition algorithm (grade 0–5 after each card).
• Quizzes — AI-generated multiple choice questions per article. Results saved to your quiz history.
• AI Tutor Mode — Tutor me button on any article opens a Socratic AI chat that asks probing questions, tests comprehension, and gives feedback.
• Spaced repetition review queue — click Review on any article to enroll it; due cards appear at /review using SM-2 scheduling.
• Daily digest — personalised in-app briefing at /digest; sections: Article of the Day, due reviews, watched updates, Did You Know, On This Day.
• Audio narration — Listen button on every article narrates the full text using browser TTS with pause/stop and a progress bar.
• Reading progress — mark articles as read. Track completion by category via the progress ring on category pages.
• Email digest — opt in under Settings → Digest to receive a scheduled summary email of watchlist changes.

• Main Page — / is the working wiki front page with live article/category/tag/revision stats, featured content, a browse directory, recently updated articles, and compact sidebar modules.
• Page headers — core browse and reference pages use a shared header with a short kicker, serif title, explanatory dek, and wrapping action buttons.
• Main menu — the three-line button in the top-left opens the simplified sidebar on phones, while desktop and tablet layouts keep the sidebar docked.
• Brand mark and compact search — the preliminary Arkivel mark appears in the sidebar/mobile header, and the header search expands only when opened.
• Arkivel Studio — /studio combines a generated article board, base-style queues, graph links, review pressure, and JSON Canvas export in one workspace.
• Discovery engines — /api/discovery reports duplicate pages, unresolved questions, canon conflicts, glossary gaps, orphan topics, topic clusters, and continue-reading opportunities.
• Bookmarks — save articles with optional notes at /bookmarks.
• Reading Lists — organize articles into ordered lists at /reading-lists. Lists can be made public and shared via a link.
• Smart Collections — saved searches with filters (tags, category, author, date range) at /collections.
• TIL (Today I Learned) — post short (280-char) notes at /til. Tag them for discovery.
• Explore mode — guided walk through articles using semantic similarity at /explore.
• Canon Trails — /trails builds guided reading routes from live wiki links, backlinks, categories, freshness, article depth, and engagement so readers get a path through the canon instead of another dashboard.
• Session reading trail — collapsible breadcrumb at the bottom of each article showing your navigation history for the current session.
• Reading history — browser-local list of the last 50 articles you visited, with relative timestamps, at /history. No server data stored.
• Last-visit badge — on return visits, articles show “You read this X ago” in the article header.
• Sticky article header — a slim floating bar with the article title, Edit and Top links appears after scrolling past the article's heading.
• Article Q&A — “Ask a question” panel at the bottom of every article; answers are grounded in wiki content and cite source articles.
• Suggest edit — a “Suggest edit” link at the bottom of every article opens an inline form where anyone can propose a correction; admins review suggestions at /admin/suggestions.
• Popularity leaderboard — /popular ranks published articles by read and reaction activity.
• Article comparison — open two articles side by side at /compare?a=slug1&b=slug2.
• Contributor leaderboard — /leaderboard shows top editors ranked by revision count.
• Discussion index — /discussions lists all open discussion threads across every article, filterable by article slug and author.
• Activity heat map — /activity shows a GitHub-style contribution calendar of daily edit counts over the past 52 weeks.
• Wiki stats — /stats displays total articles, word count, categories, tags, contributors, revisions, weekly active users, and a top-contributors leaderboard.
• Mentions feed — /mentions lists every discussion thread that mentions your @username (requires login).

• Article header — title, category, excerpt, freshness, verification, reading metrics, return-visit badge, and co-authors are grouped at the top of the page.
• Action panel — article controls are grouped as Navigate, Collect, Share, Read, and Tools.
• Taxonomy footer — category and tag links appear as wrapping chips near the bottom of the article.
• Responsive layout — article tabs, infoboxes, collapsed article tables, table of contents, backlinks, and action groups are constrained for narrow screens.
• Reading time — every article shows “~X min read” in the byline, estimated at 200 words per minute.
• Reading ETA — the byline also shows “~X min left” which updates live as you scroll through the article; disappears once you finish.
• Reading mode — click “Reading mode” in the article toolbar (or press R) to enter a distraction-free view that hides the header and sidebar. Press again or R to exit.
• Draft share links — admins can generate a secret URL (POST /api/articles/[id]/share-token) so anyone with the link can preview a draft at /share/[token] without needing to log in.
• Expiry warning banner — a yellow notice appears when an article's Review due date is within 30 days, prompting editors to verify its accuracy.
• Mark as verified — admins see a “Mark as verified” button at the bottom of each article. Clicking it stamps the current date as lastVerifiedAt, shown as a “✓ Verified” badge in the byline.
• “You might also like” — up to 5 related articles sharing the same tags are suggested at the bottom of each article.
• Floating table of contents — on wide screens (≥1280 px) a fixed sidebar TOC highlights the section currently in view.
• Article stats panel — collapsible panel at the bottom of every article showing read count, reaction count, word count, quality score, article age, and a 30-day view sparkline.
• Article flags — admins assign short labels (e.g. “Needs images”, “Outdated”) that appear as orange badges near the article title.
• Article co-authors — admins link additional contributors to an article; their names appear in the byline after the primary author.
• Named snapshots — admins can save a labeled snapshot of the current article state (e.g. “v1.0 – before major rewrite”) via POST /api/articles/[id]/snapshots.
• Cover image focal point — in the article edit form, click or drag on the cover image preview to set a focal point (X%/Y%). The focal point is stored as coverFocalX/coverFocalY and applied as object-position when the image is displayed.

• Article reactions — mark articles as Helpful, Insightful, Outdated, or Confusing via the reaction bar at the bottom.
• Star rating — rate any article 1–5 stars using the rating widget below the reaction bar; your rating is saved per session, and the average and count are shown live.
• Article checklist — per-article todo list below the article; readers can check off tasks; admins add and delete tasks via the inline form.
• Article polls — admins add polls to any article; readers vote once per session; vote counts and percentage bars are revealed after voting or when the poll is closed; admins can close, reopen, or delete polls from the poll widget.
• Blame view — visit the Blame tab on any article to see each paragraph colour-coded by the revision that first introduced it; sidebar shows editor name, date, and edit summary with a link to the full revision.
• Content warning tags — admins add CW labels to articles in the edit form; readers see a dismissible amber banner (Spoilers, Violence, Mature content, etc.) before the article body.
• Article forks — propose a complete rewrite of any article. Admins review, merge, or reject forks at /forks.
• Review requests — editors can request review from an article action, assign or self-assign a reviewer, discuss the draft at /reviews, approve to publish, request changes, reject, or resubmit after fixes.
• Claim Review Mode — claims marked in the editor appear in the article claims panel. Editors can approve, request a source, dispute, reject, or leave notes for each claim.
• Knowledge bounties — request articles on specific topics at /bounties. Contributors can claim and fulfil them.
• Expert badges — admins grant expert badges per category. Expert contributors are highlighted in revision history and bylines.
• Article certification — admins can certify articles reviewed by at least two experts. Certified articles show a “Verified by experts” badge.
• Discussions — every article has a Discussion tab. Mention @username to notify a contributor.
• Article lock — opening the editor acquires a 10-minute lock. Other users editing the same article simultaneously see a “Being edited by X” warning banner; admins can force-unlock.
• Revision restore — on the article history page, click “restore” next to any revision to revert to it (current content is auto-saved as a new revision first).

• Dyslexia mode (Aa) — click Aa in the action bar to switch to OpenDyslexic font with increased spacing and a warm background tint. Persists across sessions.
• RTL toggle — click RTL to switch article content to right-to-left reading direction.
• Audio narration — click Listen on any article to hear it read aloud. Uses ElevenLabs if configured; otherwise browser speech synthesis. Includes speed control.
• Machine translation — click Translate ▾ and select a language. Creates a draft translation via DeepL or Google Translate (requires API key).
• Skip-to-content link — first focusable element on every page, visible on keyboard focus.

Categories are hierarchical groups shown in the sidebar. Each article belongs to one category. Browse all at Categories.

Tags are hierarchical labels; an article can have multiple tags. Browse all at Tags, which shows a size-scaled tag cloud.

• Every save auto-snapshots the current state as a revision
• Click the History tab on any article to see all past revisions
• Select two revisions and click Compare for a side-by-side diff
• Added text shown in green, removed in red

Import

• File upload: drag-and-drop .md, .txt, .html, or .json at Import
• Obsidian vault: upload a .zip at /import/obsidian. Front matter and [[wikilinks]] are resolved automatically.
• Notion: connect your Notion integration token and import a page tree at /import/notion.

Export

• PDF — print-ready window using your browser's print dialog
• Markdown — downloads as a .md file
• ePub — downloads as a valid ePub 3 e-book
• Word (.docx) — downloads as a Microsoft Word document
• Category export: export an entire category as a multi-chapter ePub or zip from the admin area
• Bulk ZIP export: download the entire wiki (or one category) as a .zip of Markdown files from the Export page — one .md per article with YAML front-matter, organised in category subfolders

All export formats are in the Export ▾ dropdown on every article page.

Confluence import

Upload a Confluence HTML export file or paste the HTML directly at /admin/import. The title is extracted from the page heading and Confluence macros are stripped. The result is saved as a draft article.

Save content from the web directly into the wiki without leaving your browser.

Browser extension

Install the Manifest V3 browser extension (Chrome, Edge, Brave) from /clipper-extension. Click the extension popup on any page: the title and selected text are pre-filled; choose a category and click Save to Wiki. The article is created as a draft and the popup offers “Open editor” to refine it.

Bookmarklet

Go to /bookmarklet and drag the button to your bookmarks bar (or copy the code). Click the bookmarklet on any page to clip the URL, title, and selected text as a draft article. Selected text is wrapped in a blockquote with a source link; full-page HTML has nav/headers/scripts stripped.

Create standalone Excalidraw canvases at /whiteboards. These are separate from the Excalidraw blocks you can embed inside articles.

• Create unlimited named canvases; the canvas auto-saves 2 seconds after each change
• Edit the title inline at the top of the editor
• Full Excalidraw toolkit: shapes, text, arrows, images, freehand drawing

Your personalized homepage at /dashboard shows a grid of widgets you can rearrange and toggle.

• Available widgets: Recent articles, Watchlist, Recent edits, Random article, Scratchpad preview, Wiki stats, Notifications
• Click Customize to show/hide widgets and drag cards to reorder them
• Layout is saved to your user preferences and restored on every visit

• Analytics dashboard — scroll depth heatmap, reader navigation paths, search gap tracking
• Arkivel Studio — /studio turns live wiki data into a portable visual workspace with base views and next moves
• Studio API — /api/studio returns the generated board, bases, links, and action queue; /api/studio/canvas downloads the board as JSON Canvas
• Canon Atlas — /atlas turns the wiki into a live map of territories, article signals, story threads, a flagship dossier, continuity pressure, and atlas moves
• Atlas API — /api/atlas returns the same territories, signals, threads, dossier, continuity pressure, and action queue as JSON
• Canon Trails — /trails turns the wiki into guided reading routes through strongest canon, recent updates, deep pages, and repair paths
• Trails API — /api/trails returns guided reading routes, stop reasons, estimates, word totals, and link totals as JSON
• Knowledge Command Center — /intelligence combines mission readiness, editorial queue pressure, graph gaps, stale content, taxonomy debt, reader demand, and cleanup flags into one cockpit with an article constellation, readiness radar, impact simulator, and 20 operational engines
• Intelligence API — /api/intelligence returns the same score, summary, graph constellation, radar axes, pressure model, 20 engines, and action queue as JSON
• Search analytics — /admin/search-analytics shows daily search volume, top queries with average result counts, and zero-result queries to surface content gaps
• Search gaps — /admin/search-gaps shows top zero-result queries
• Stale articles — /admin/staleness lists articles not updated in 180+ days
• Wiki health score — /admin/health gives an A–F grade: link coverage, freshness, stub %, search gap %, certification %
• Wiki Health Dashboard — /health audits all articles for stubs, outdated content, missing excerpts, missing categories/tags, and broken wiki links; shows a 0–100 health score with per-article fix links
• Embeddings coverage — /admin/embeddings shows AI embedding status per article
• Maintenance mode — /admin/maintenance toggle displays a site-wide yellow banner while the wiki is under maintenance
• Cleanup tags — flag articles with attention labels (Needs Images, Stub, Outdated, etc.); shown as orange banner on article page; set in article edit form
• Article adoption — mark articles as abandoned in the edit form; adoption banner with one-click claim appears on the article page
• Scheduled announcements — set a “Go live at” time on banners; shown only once that time is reached
• Read-only mode — /admin/read-only disables editing for non-admins; blue banner shown site-wide
• Revision pruning — /admin/prune-revisions deletes old revisions beyond a configurable keep threshold
• User activity log — /admin/user-activity shows any user's full revision history
• Writing velocity — /admin/writing-velocity bar chart of words added per week over the last 12 weeks
• Session management — /settings/sessions shows active sessions (device, IP, dates); revoke any session
• AI tag & category suggestions — “AI suggest” buttons in article edit form suggest relevant tags and best-fit category from content
• AI title suggestions — “AI suggest” next to the title field returns 5 alternative encyclopedic titles; click any to apply
• Featured article badge — admins can mark articles as Featured; a gold star badge is displayed in the article header
• Auto-save indicator — article edit form auto-saves draft to localStorage after 2 s of inactivity; “Unsaved changes” / “Draft saved” shown above editor
• Editor reliability — 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 article byline
• Did-you-mean suggestions — zero-result search shows the closest matching article title as a clickable suggestion
• 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
• Category growth chart — /admin/category-growth; stacked bar chart of new articles per category per month (last 12 months)
• Image lightbox — click any image in article content to view full-size; close with Esc or click outside
• AI expand section — “AI Expand” in editor toolbar; select a paragraph, click to expand into more detail with AI
• Smart URL paste — pasting a plain HTTP/HTTPS URL in the editor auto-creates a hyperlink; if text is selected the URL becomes its href, otherwise it is inserted as linked text
• Typewriter scrolling mode — “Typewriter” toggle in the editor toolbar keeps the cursor vertically centred as you type; preference persisted to localStorage
• Short-article merger suggestions — /admin/short-articles; lists stub articles under 100 words and suggests up to 3 same-category merge targets
• Sidebar position — the Dock left/right button in the sidebar footer moves the desktop sidebar to either side with matching borders; the top-left main-menu icon collapses or expands it on larger screens, and both preferences persist to localStorage
• Page titles — browser tabs use Arkivel - Page Name, with the visible page heading used as the fallback when a route does not define metadata
• Tabbed content blocks — /tabs slash command inserts an interactive two-tab block; panels are editable inline
• Gallery grid blocks — /gallery slash command inserts a responsive image grid with captions
• AI wiki assistant — floating chat button on every article page; ask questions about the current article or the whole wiki; context-aware conversation powered by AI
• AI article generation — “AI Generate” in editor toolbar; reads document headings and fills in encyclopedic paragraph content under each section
• Button / CTA blocks — /button slash command inserts a 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 next to the edit summary field auto-generates a concise one-sentence description of what changed
• Article quiz mode — “Quiz me” button in article tools bar; AI generates 5 multiple-choice questions from the article; shows score and records attempt
• Ask my wiki — full-page AI oracle at /ask; streaming answers grounded in your wiki content via semantic search; source article chips; multi-turn conversation; linked from sidebar
• Knowledge synthesis — “Synthesize” button on category pages; AI reads all articles and writes a comprehensive overview; preview modal; one-click to create as a new article
• Presentation mode — “Present” button on any article; opens /present/[slug]; cinematic full-screen slideshow with a scrollable slide stage, keyboard navigation, slide overview grid (G), fullscreen (F), and responsive controls that avoid overlap
• Bulk JSON export — /api/export/json downloads all articles as structured JSON (admin only)
• Per-article analytics — /articles/[slug]/analytics; 30-day view chart + summary stats
• Series progress tracker — series navigation shows “X of N read” from browser reading history
• Writing session goal — enter a word-count target in the editor status bar and click Start; a progress bar, elapsed timer, and green completion indicator track your session in real time
• Long article suggestions — /admin/long-articles flags published articles over a word threshold (default 5,000); threshold adjustable via the form; linked from admin sidebar
• Random article — click “Random article” in the sidebar Discover section or the “Random” button on any category page to jump to a random published article; category-filtered via /api/random?category=slug
• New articles feed — homepage sidebar widget listing recently created articles (sorted by creation date, not last edit)
• Top referrers dashboard — /admin/referrers shows top 30 referring domains with bar charts; toggle 7/30/90-day windows; linked from admin sidebar
• Tag usage trends — /admin/tag-trends heat-map table of new articles per tag per month (last 12 months); linked from admin sidebar
• Analytics CSV export — /api/export/analytics downloads a CSV of all published articles including read counts, reactions, revision counts, category, and dates (admin only)

Achievements are awarded automatically based on contribution activity:

• First edit, 10 edits, 100 edits — contribution milestones
• 7-day streak / 30-day streak — editing on consecutive days
• Category expert — significant contributions to a single category

Unlock notifications appear as a toast after saving.

• Slack: /wiki <query> slash command to search articles from Slack. Requires SLACK_SIGNING_SECRET.
• Discord: /wiki slash command in Discord. Requires DISCORD_PUBLIC_KEY.
• Issue links: link GitHub, Jira, or Linear issues to articles. Status badges appear inline on the article page.
• Embeds: generate an embed token for any article. The view at /embed/[token] is iframe-safe with no navigation.

Optional feature, disabled by default. Enable with NEXT_PUBLIC_MAP_ENABLED=true.

• Multiple maps with background images and layers
• Clickable polygon areas linked to articles with hover tooltips
• Zoomable with different detail levels per zoom
• Edit mode: draw, reshape, recolor, link to articles (admin only)

On desktop and tablet, the top-left three-line button collapses or expands the simplified sidebar, section headers fold individual groups, and Dock left/right in the footer chooses the sidebar side. The sidebar starts with navigation rather than repeating the app brand. On phones, the same top-left button opens the menu as an overlay, while the bottom navigation keeps Home, Search, Create, and Recent one tap away.

Use Cmd+K / Ctrl+K to open the command palette from anywhere. It groups destinations across navigation, discovery, personal, reference, and admin areas, then searches articles in the same panel when you type a query.

Navigation

• Main Page, All articles, Recent changes, Random article
• Search, Tags, Arkivel Studio, Canon atlas, Canon trails, Article graph

Discover

• Explore — curated entry points; Activity — recent contribution feed; Command center — live wiki cockpit and intelligence engines
• Collections, Change requests, Review requests, Bounties, Forks

Personal

• Dashboard, Reading lists, Bookmarks, Watchlist
• Flashcards, Learning paths, Today I Learned, Scratchpad, Settings

Tools

• Whiteboards, Timeline, Bookmarklet, Clipper extension

Article structure

• Backlinks: “What links here” at the bottom of every article
• Table of contents: auto-generated for articles with multiple headings
• Breadcrumb: category hierarchy shown above the article title
• Disambiguation: articles with ambiguous titles get a notice
• Redirects: set a “Redirect to” slug in the editor to forward the old URL automatically

• Roles: Viewer (read only), Editor (create/edit), Admin (full access)
• Legacy admin login: enter the ADMIN_SECRET at /admin; works alongside user accounts
• Dashboard — review queue, statistics, embed tokens
• Analytics, Metrics, Operations, Health
• Plugins, Webhooks, Templates, Theme
• Content lint, Knowledge gaps, Search gaps, Staleness, Embeddings
• Dead-end articles, Duplicate content, Orphan articles — content health tools for finding articles with no outgoing links, similar content, or no incoming links
• Macros, Content schedule, Kanban board, Audit log with filters and redacted export
• Metadata schemas — define typed fields per category; Federated peers — configure peer wikis for cross-wiki search
• Import tools — Confluence, Notion, Obsidian import in one place
• Operations dashboard: /admin/operations, service health, queues, slow pages, failed webhooks, imports, exports, plugin errors, database health, admin alerts, browser-local acknowledgements, and redacted support bundles
• Maintenance tooling: /admin/maintenance, safe-upgrade checks, backup reminders, background task pausing, cleanup queues, and runbook links
• Observability: /admin/observability, structured operational events, metric ingestion, privacy controls, and external collector guidance
• Performance budgets: /admin/performance, route budgets, large-wiki fixtures, slow samples, and Prisma query review guidance
• Cache strategy: /admin/cache, invalidation rules, manual invalidation, stale warnings, Redis status, and deployment recipes
• Offline/PWA: docs/offline-pwa.md and /api/offline/contract cover install prompts, offline reading, stale indicators, retry queues, mobile QA, draft warnings, and privacy limits
• Mobile polish: docs/mobile-polish.md and /api/mobile-polish cover responsive QA, touch targets, safe areas, overflow/clipping checks, dialog bounds, and mobile help screenshot slots
• Desktop research: docs/desktop-app-research.md and /api/desktop-research cover local packaging tradeoffs, deployment recipes, filesystem import/export UX, and the research-only v5 decision
• Accessibility finish: docs/accessibility.md and /api/accessibility cover keyboard/focus/dialog/dropdown/control audits, widget summaries, contrast/motion checks, contribution guidance, and release blockers
• Security review: docs/security-review.md and /api/security/review cover browser headers, reviewed surfaces, abuse-case gates, supply-chain checks, and the pre-v5 threat-model draft
• Privacy controls: docs/privacy-controls.md and /api/privacy/controls cover deployment modes, retention defaults, user export/deletion planning, and warnings for AI, webhooks, exports, feeds, and indexing
• Marketplace security: docs/secure-marketplace-plugins.md and /api/marketplace/security cover unsafe pack rejection, blocked permissions/hooks, dangerous plugin capabilities, provenance checks, and local-only installation
• Marketplace beta: docs/marketplace-beta.md and /api/marketplace/beta cover beta metrics, featured/recent/recommended packs, collections, compatibility badges, search facets, install-intent steps, and limitations
• Marketplace lifecycle: docs/marketplace-lifecycle.md and /api/marketplace/lifecycle cover pack states, transitions, local inventory, health checks, preview media validation, update metadata, compatibility warnings, and rollback guidance
• Marketplace authoring: docs/marketplace-authoring.md and /api/marketplace/authoring cover author dashboard metadata, README generation, checklist coverage, compatibility matrix output, quality expectations, and submission templates
• Template marketplace: docs/template-marketplace.md and /api/marketplace/templates cover template-pack listings, included schema, category and article previews, compatibility notes, diff/merge contracts, and export-from-space fixture output
• Sync manifests: docs/sync-manifests.md and /api/sync-manifests cover source/target manifests, checksums, dry-run reports, signed snapshot plans, staging promotion checks, and the network-federation release gate
• External references: docs/external-references.md and /api/external-references cover imported/mirrored provenance labels, broken-reference diagnostics, and public index privacy planning
• Archive mirrors: docs/archive-mirror-workflows.md and /api/archive-mirrors cover read-only archive snapshots, private mirrors, selected-space transfers, repeated-sync conflict notes, and the pre-v5 federation decision checkpoint
• Migration readiness: docs/migration-readiness.md and /api/migration-readiness cover blocking migration dry runs, backup prompts, schema compatibility reports, restore validation, representative v4 upgrade paths, and failure recovery guidance
• Backup and restore: docs/backup-restore.md and /api/backup-restore cover admin backup wizard sections, restore rehearsal validation, scheduled backup planning, external storage notes, and disaster-recovery drill guidance
• Upgrade assistant: docs/v5-upgrade-planning.md and /api/upgrade-assistant cover v5 readiness checks, pre-upgrade diagnostics, post-upgrade smoke checks, compatibility warnings, and release-note/migration doc links
• Test quality gates: docs/test-quality-gates.md and /api/test-quality cover expanded test surfaces, stable QA fixtures, CI matrix planning, warning policy, and release-manager dashboard planning
• E2E smoke suite: docs/e2e-smoke-suite.md, /api/e2e-smoke-suite, and e2e/smoke-suite.spec.ts cover product smoke flows, responsive routes, fixture seeding, and failure screenshots/traces
• Release gates: docs/release-gate-automation.md, /api/release-gates, and scripts/verify-docs-sync.mjs cover release candidate gates, docs sync verification, checklist metadata, known issues, and blocker labels
• Documentation onboarding: docs/index.md, docs/maintainer-guide.md, and /api/documentation-onboarding cover maintainer docs, setup paths, troubleshooting, docs IA, and practical link-test coverage
• In-app onboarding: docs/in-app-onboarding.md, /api/in-app-onboarding, and examples/onboarding/demo-content-pack.json cover first-run setup, guided admin onboarding, contextual help panel planning, demo content, and screenshot checkpoints
• Example site recipes: docs/example-site-recipes.md, /api/example-site-recipes, and examples/recipes/site-recipes.json cover setup recipes, env snippets, screenshot targets, pack recommendations, migration stories, and v5 readiness checks
• Feature freeze: docs/feature-freeze.md, /api/release-freeze, and docs/known-issues.md cover freeze policy, rehearsal matrix, blocker labels, v5 gate ownership, and release-note draft sections
• Release candidate one: docs/release-candidate-one.md, /api/release-candidate-one, and docs/rc-feedback-template.md cover RC1 gates, deployment validation, starter/pack/import/export validation, review checklists, and feedback reporting
• Final release gates: docs/final-release-gates.md and /api/final-release-gates cover RC fixes, final beta freeze contracts, gate evidence, compatibility targets, correction windows, and stable v5 release gates
• Batch operations: on All Articles, bulk-assign category, publish/unpublish, or delete
• Customization: name, tagline, welcome text, footer set via NEXT_PUBLIC_* environment variables
• Customization manifest: /api/customization, public grouped config, supported env vars, style presets, color themes, layouts, reusable component catalog, editor control contract, collaboration UX contract, public API v1 contract, SDK type contract, webhook reliability contract, operations dashboard contract, maintenance tooling contract, observability contract, performance budget contract, cache strategy contract, offline/PWA contract, mobile polish contract, desktop research contract, accessibility finish contract, migration readiness contract, backup/restore contract, upgrade assistant contract, test quality gates contract, e2e smoke suite contract, release gate automation contract, documentation onboarding contract, in-app onboarding contract, example site recipes contract, feature freeze contract, release candidate one contract, final release gate contract, security review contract, privacy controls contract, marketplace security contract, marketplace beta contract, marketplace lifecycle contract, marketplace authoring contract, template marketplace contract, sync manifest contract, external reference contract, archive mirror contract, component slot contracts, persisted space customization contract, marketplace registry/import-preview metadata, plugin manifest schema/examples/compatibility matrix, plugin manifests, theme packs, template packs, migration guidance, and theme hooks for self-hosters and plugins
• Trusted local plugins: /admin/plugins discovers trusted local plugin.json manifests only when ARKIVEL_ENABLE_TRUSTED_PLUGINS=true and ARKIVEL_TRUSTED_PLUGIN_DIR points to an absolute local directory. Review permissions, routes, widgets, hooks, compatibility, source, and load errors before enabling a plugin.
• Plugin security boundary: v1 plugins are trusted-local and manifest-first. Arkivel does not fetch remote plugin code or run arbitrary install scripts; admins review permission prompts, risk labels, health metadata, routes, widgets, hooks, and audit-backed enable/disable changes before future runtime sandbox work expands execution.
• Plugin authoring: start from examples/plugins/starter-plugin/, validate with npm run plugin:validate -- path/to/plugin.json, list supported surfaces with npm run plugin:validate -- --list-surfaces, and use docs/plugin-authoring.md plus examples/plugins/marketplace-listing-template.json for compatibility notes and submission prep.
• Portable bundles: docs/portable-bundles.md defines the full-site bundle manifest, checksums, source metadata, export scope, privacy filters, and dry-run import report before v5. Sessions, API keys, and analytics are excluded by default.
• Export history: /api/export/history lists recent admin export reports, and /api/export/history?download=1 downloads the report JSON. Export manifests include file counts, byte counts, checksums, warnings, omitted private data, format, status, and scope.
• Audit trail: docs/audit-trail.md documents immutable event coverage, actor/target/workspace/severity/date filters, redacted JSON exports, alert hooks, and retention defaults.
• Moderation: docs/moderation.md covers discussion reports, reviewer-only visibility, suggestion review actions, public contribution spam scoring, and rate-limit planning.
• Import rehearsal: /api/import/rehearsal previews dry-run import reports with conflict categories, recommended actions, blocked changes, rollback plans, and fixture profiles. v4.81.2 rehearsals are intentionally no-write.
• Workspaces: docs/workspaces.md covers bootstrap profiles, invitations, scoped APIs, marketplace selections, and the single-workspace migration path.
• Role templates: docs/role-templates.md covers role templates, permission matrices, invitation resend/revoke audit events, API-key behavior, and self-host admin recovery.
• Private team knowledge base: docs/private-team-knowledge-base.md covers private workspace setup, collaboration controls, user preferences, and public-surface visibility checks for RSS, Atom, sitemap, and API v1.
• Editorial governance: docs/editorial-governance.md covers review governance, claim queues, verification stamps, ownership/escalation paths, and release-blocker summary cards.
• Space customization API: /api/categories/:id/customization and /api/articles/:id/customization resolve global, parent category, category, and article overrides for appearance, component pack, template pack, navigation, and metadata schema. Public reads hide privateDraftConfig; admin PUT requests validate and persist overrides.
• Space customization editor: /admin/categories includes the admin editor for category-space overrides, inherited value previews, explicit override markers, reset-to-parent/global controls, conflict warnings, landing previews, and responsive QA checkpoints.
• Space templates: /api/space-templates returns built-in personal wiki, product docs, team handbook, worldbuilding bible, research notebook, reading archive, project knowledge base, and public documentation templates. /space-templates/:id previews each starter space, and POST /api/space-templates previews imported template JSON or a one-click local import preview for a templateId before any future apply flow; authoring notes live in docs/space-templates.md.
• Domain workflows: /api/space-workflows and docs/domain-workflows.md describe docs portal, team handbook, worldbuilding, research, and personal wiki workflow controls, steps, starter template links, and release gates.
• Space governance: /api/categories/:id/governance stores inherited owner, reviewer, default visibility, review cadence, stale-page threshold, and required health signals. Article pages show inherited governance badges; the admin dashboard summarizes stale pages, draft/review articles, and configured health widgets.
• Component packs: built-in 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: Customization Studio previews the selected layout's shell density, homepage order, article columns, right rail, dashboard modules, category landing behavior, and scoped html[data-layout="..."] hooks
• Component-pack authoring: use npm run marketplace:generate-component-pack, npm run marketplace:validate-pack, examples/marketplace/component-pack, and docs/component-pack-preview-harness.md to scaffold, validate, document, and plan preview-safe packs
• Style preset: Set NEXT_PUBLIC_ARKIVEL_STYLE to classic-wiki or atlas-modern, then rebuild/redeploy because NEXT_PUBLIC_* values are build-time config
• Color theme: Set NEXT_PUBLIC_ARKIVEL_COLOR_THEME to standard, forest, or ember, then rebuild/redeploy because NEXT_PUBLIC_* values are build-time config
• Layout preset: Set NEXT_PUBLIC_ARKIVEL_LAYOUT to classic-wiki, docs-portal, team-knowledge-base, worldbuilding-atlas, or research-notebook
• Admin customization: /admin/customization is a tabbed env-first workbench for brand copy, logos, style presets, color themes, layout presets, 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, live preview panels, source badges, theme-pack validation, downloadable support reports, and copy-ready .env, .env.local, Vercel, or Docker Compose values; /admin/marketplace filters the versioned local registry, opens item detail panels, copies env vars/pack JSON/plugin manifests/install notes, and previews pasted/uploaded pack JSON with schema, source, license, checksum, token diff, and validation health
• Marketplace contributions: use docs/marketplace-contributions.md, examples/marketplace/, and the GitHub marketplace issue templates when preparing preview-safe style, theme, layout, component, plugin, or template pack submissions

Documentation and versioning are part of every release. User-visible, API, schema, configuration, workflow, design, or contributor-guidance changes should update the matching references in the same commit.

• Root docs: README.md, CHANGELOG.md, ROADMAP.md, DESIGN.md, ARCHITECTURE.md, CONTRIBUTING.md, and AGENTS.md
• Product docs: docs/help.md, docs/features.md, /help, /features, and /api-docs when relevant
• Version metadata: bump package.json and package-lock.json; patch for docs/process/UI copy, minor for new capabilities, major for breaking changes
• Commit messages: release commits use vX.Y.Z: imperative summary, dependency commits keep build(deps): ..., and non-version commits use a short imperative subject

• Register with username, email, and password
• User profiles at /users/username show contribution history and achievements
• Manage display name, password, notifications, digest schedule, and accessibility defaults at /settings

• Watch articles to get notified when they're edited. Manage your watchlist from the sidebar.
• The bell icon in the header shows unread notification count
• @username mentions in discussions trigger a notification
• Enable the daily digest under Settings → Digest for a scheduled summary email

• RSS: /feed.xml
• Atom: /feed/atom
• Public REST API v1: /api/v1/ with X-API-Key authentication. See API Documentation.
• GraphQL API: /api/graphql — interactive GraphiQL playground at the same URL (GET). Supports queries for articles, categories, tags, revisions, search, and wiki stats.
• Webhooks: configure HTTP callbacks for article events at /admin/webhooks; delivery log included.
• Operations: /admin/operations and /api/admin/operations?bundle=1 provide admin-only health and diagnostic data for operators.
• Maintenance: /api/admin/maintenance/report provides admin-only upgrade readiness, cleanup queue, and background pause data.
• Observability: /api/admin/observability and /api/observability/metrics provide structured event feed and metric ingestion data.
• Performance: /api/admin/performance provides route budget status, large-wiki fixtures, slow samples, and slow-query review data.
• Cache: /api/admin/cache provides admin-only cache status, invalidation rules, stale warnings, and manual invalidation actions.
• Offline/PWA: /api/offline/contract provides public install metadata, service-worker cache rules, stale indicators, retry queue limits, mobile QA checkpoints, draft warnings, and privacy limits.
• Mobile polish: /api/mobile-polish provides responsive QA checkpoints, mobile regression checks, and screenshot slot metadata.
• Accessibility finish: /api/accessibility provides accessibility audit surfaces, screen-reader summaries, contrast/motion checks, and v5 blocker metadata.
• Security review: /api/security/review provides browser header metadata, reviewed security surfaces, abuse-case gates, dependency review checklist, and the pre-v5 threat-model draft.
• Privacy controls: /api/privacy/controls provides deployment-mode controls, retention settings, user data export/deletion planning, and warnings for AI/external integrations.
• Marketplace security: /api/marketplace/security provides blocked permissions/hooks, dangerous plugin capability warnings, provenance requirements, and local-only installation guidance.
• Marketplace beta: /api/marketplace/beta provides beta metrics, featured/recent/recommended pack ids, collections, compatibility badges, search facets, install-intent steps, and limitations.
• Marketplace lifecycle: /api/marketplace/lifecycle provides pack states, allowed transitions, local inventory, health checks, preview media validation, update metadata, compatibility warnings, and rollback guidance.
• Marketplace authoring: /api/marketplace/authoring provides author dashboard sections, README/checklist generation metadata, compatibility matrix rows, docs completeness checks, and submission template references.
• Template marketplace: /api/marketplace/templates provides template-pack previews, included schema, compatibility notes, diff/merge contracts, and export-from-space fixture output.
• Sync manifests: /api/sync-manifests provides source/target manifest metadata, section checksums, dry-run reports, signed snapshot planning, staging promotion guidance, and the network-federation release gate.
• External references: /api/external-references provides cross-instance reference metadata, provenance labels, diagnostics, and privacy-safe public index planning.
• Archive mirrors: /api/archive-mirrors provides read-only archive snapshot, private mirror, selected-space transfer, repeated-sync conflict, and federation decision metadata.

Global

In the editor (Ctrl = Cmd on Mac)