Cogita themes are more than colors and typography. A theme owns page layouts, visual language, and a declared set of default plugin capabilities. A site selects a theme and supplies its content and navigation.
| Theme | Best for | Focus | Package |
|---|---|---|---|
| Docs | Handbooks, API references, knowledge bases | Navigation, code reading, page search | @cogita/theme-docs |
| Lucid | Personal blogs and archives | Posts, topics, search, reading flow | @cogita/theme-lucid |
| Editorial | Feature writing and series | Headlines, featured content, editorial rhythm | @cogita/theme-editorial |
| Knowledge | Wikis, research notes, mixed repositories | Unified content, search, topics, backlinks | @cogita/theme-knowledge |
Each theme has an independent consumer under demos/. Run pnpm run demo to build and preview all four.
Try each theme with an independent site and custom sample content:
| Demo | What to look for | Link |
|---|---|---|
| Docs | Handbook navigation, focused reading, and reference pages | Open the Docs demo |
| Lucid | A lightweight publishing flow for notes and archives | Open the Lucid demo |
| Editorial | Feature-led storytelling and curated series | Open the Editorial demo |
| Knowledge | Posts, documents, JSON, Git sources, and backlinks in one space | Open the Knowledge demo |
The full demo showcase is the fastest way to compare the four content experiences. Each demo is also included in this repository so you can inspect its configuration and sample content.
Docs is designed for lookup and understanding. It provides chapter navigation, a focused reading area, and a page outline for handbooks, architecture notes, API references, and plugin documentation.
Lucid is designed for continuous publishing and browsing. It emphasizes post lists, topics, categories, search, reading progress, and subscription entry points.
Editorial is designed for series and narrative. It uses stronger heading hierarchy, featured posts, and card rhythm for project stories, research notes, and opinion-led content.
Knowledge is designed for connection and retrieval. It brings posts and contentDir into one content entry point and combines search, topics, content relations, and external JSON or Git sources.
All official themes are English-first and support @cogita/plugin-i18n. The interface can be translated through i18n.messages without rewriting article content.