Warning
Cortext is an experimental prototype. Do not use it on production sites or with data you cannot afford to lose.
The data layer will change. Post types, meta keys, REST responses, block attributes, theme tokens, and stored content shapes are not stable yet.
We are not writing migrations for early builds. Treat anything you create with Cortext today as throwaway data.
A WordPress plugin for building a knowledge base inside your own site: nested pages, typed collections, multiple views, and publishing through WordPress.
WordPress already has the hard parts: ownership, publishing, export, themes, and a data model people can inspect without Cortext. This project tries to make those pieces feel like one knowledge base instead of a pile of admin screens.
Because it is still WordPress, Cortext can publish knowledge base entries as themed public pages, run locally, and keep data in ordinary WordPress storage.
Cortext stores documents, collection definitions, fields, and collection rows as WordPress posts and post meta. The admin UI is a React shell that combines a WordPress block editor for documents with collection views built on WordPress packages.
- Getting started: install, run, day-to-day commands.
- Vision and principles: what drives the design.
- Architecture: current storage and shell overview.
- Shell architecture: React shell, mount point, editor setup.
- Data model: implementation notes and current status.
- Theming: shell vs content themes, and current token notes.
- Roadmap: what ships when.
- WordPress 6.9+
- PHP 8.1+
- A recent block theme is recommended but not required.
Quick start:
./scripts/setup.sh # install deps, assign a per-worktree port
./scripts/run.sh # boot wp-env, seed demo data, start the JS watcher
./scripts/archive.sh # stop the detached wp-env environment
Runs on Docker via wp-env. Parallel worktrees get deterministic per-path ports so branches and agents do not collide. Demo data is opt-in: ./scripts/run.sh and pnpm run env:start:seed seed it; plain wp-env start does not. Full workflow, contribution notes, and command reference in Getting started.