How scottidler/riki works
riki is a Git-backed Markdown wiki: readers request pages that the server renders from the wiki’s validated good commit, while editors load, modify, and save pages through the same URL. Saves create Git commits and publish only index-valid tips; a background poller fetches upstream changes. The graph includes the documented editor capabilities and service subsystems, but unsampled source limits some internal call relationships, which are left unconnected rather than inferred.
Main entry points: wiki.rs Wiki publish · setup.ts Editor setup · routes.rs HTTP routes · pages.rs Page handlers
Components 29
HTTP service
- HTTP routes
server/src/routes.rs - Page handlers
server/src/pages.rs - Save API
server/src/api.rs - HTML assembly
server/src/render.rs - Editor assets
server/src/assets.rs - Service config
server/src/config.rs - Request identity
server/src/identity.rs
Wiki core
- Wiki publish
core/src/wiki.rs - Git content store
core/src/store.rs - Navigation index
core/src/index.rs - Markdown rendering
core/src/render.rs - Page model
core/src/page.rs - Path validation
core/src/path.rs - Save logic
core/src/save.rs - Runtime status
core/src/runtime.rs
Browser editor
- Editor entry
editor/src/main.ts - Edit session
editor/src/session.ts - Editor API client
editor/src/api.ts - Editor setup
editor/src/setup.ts - Editing toolbar
editor/src/toolbar.ts - Task editing
editor/src/tasks.ts - Editor alerts
editor/src/alert.ts - Image handling
editor/src/images.ts - Table editing
editor/src/table.ts - Page interactions
editor/src/page/ui.ts
Operations
- Upstream poller
server/src/poller.rs
Other components
- Wiki reader
- Editor user
- Git upstream
Connections 32
- Wiki reader → HTTP routes: requests pages
README.md - Editor user → Editor entry: starts editing
editor/src/main.ts - HTTP routes → Page handlers: routes page requests
server/src/routes.rs - HTTP routes → Save API: merges API routes
server/src/routes.rs - HTTP routes → Editor assets: routes assets
server/src/routes.rs - Page handlers → Wiki publish: reads wiki state
- Page handlers → Markdown rendering: renders content
server/src/pages.rs - Page handlers → HTML assembly: assembles response
server/src/pages.rs - HTML assembly → Navigation index: uses page tree
server/src/render.rs - Save API → Request identity: resolves identity
server/src/api.rs - Save API → Save logic: saves page
- Save logic → Git content store: commits changes
core/src/save.rs - Save logic → Wiki publish: publishes saved tip
core/src/save.rs - Wiki publish → Git content store: fetches and reads
core/src/wiki.rs - Wiki publish → Navigation index: builds index
core/src/wiki.rs - Wiki publish → Markdown rendering: extracts titles
core/src/wiki.rs - Git content store → Git upstream: fetches and pushes
- Editor entry → Edit session: opens session
editor/src/main.ts - Edit session → Editor API client: loads and saves
editor/src/session.ts - Edit session → Editor setup: creates editor
editor/src/session.ts - Edit session → Editing toolbar: builds toolbar
editor/src/session.ts - Editor setup → Editor alerts: registers alerts
editor/src/setup.ts - Editor setup → Image handling: registers images
editor/src/setup.ts - Editor setup → Table editing: registers tables
editor/src/setup.ts - Editor setup → Task editing: registers task editing
editor/src/setup.ts - Editing toolbar → Editor alerts: uses alert controls
editor/src/toolbar.ts - Editing toolbar → Table editing: uses table controls
editor/src/toolbar.ts - Editing toolbar → Task editing: uses task controls
editor/src/toolbar.ts - Page interactions → Editor entry: decorates rendered pages
- Upstream poller → Wiki publish: polls for updates
- Service config → HTTP routes: configures service
server/src/config.rs - Path validation → Git content store: validates paths
core/src/store.rs