Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Try Cortext:
WordPress plugin:
Desktop app:
Warning
Cortext is an early beta. Try it somewhere low-stakes first.
Some things may change during the beta, so do not make it the only place for important work yet.
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.
The easiest way to try Cortext is from the WordPress plugin directory.
- In wp-admin, go to Plugins, then Add New.
- Search for "Cortext", install it, and activate it.
- Open "Cortext" from the admin menu.
New to Cortext? Using Cortext walks through the main pieces and the basic tasks.
Cortext needs WordPress 7.0+ and PHP 8.1+. If you prefer a ZIP, download it from the WordPress.org plugin page or from GitHub Releases.
- Using Cortext: the main pieces and how to get around.
- Getting started: set up from source, run, day-to-day commands.
- Playground: try Cortext in WordPress Playground and prepare the gallery files.
- Release process: milestones, labels, and changelog previews.
- 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 7.0+
- 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.