A team knowledge-sharing platform built with Docusaurus. Engineers write it, engineers read it.
Live site → ceycode.github.io/dev-hub
Knowledge Base → ceycode.github.io/dev-hub/kb
Blog → ceycode.github.io/dev-hub/blog
| Section | Purpose |
|---|---|
| Knowledge Base | Reference articles — concepts, guides, comparisons, best practices |
| Blog | TILs, quick tips, personal experience write-ups |
| Tags | Cross-cutting index across all content |
Knowledge base content lives in docs/ organised by category (Languages, Frameworks, Tools, Concepts, Best Practices). Blog posts live in blog/.
Prerequisites: Node.js 18+
npm install
npm start # dev server at http://localhost:3000Most edits (markdown, config) hot-reload without a restart.
npm run build # production build → build/
npm run serve # preview the production build locallyThe site deploys automatically to GitHub Pages via GitHub Actions on every push to main.
To deploy manually:
npm run deployThis builds and pushes to the gh-pages branch.
See docs/contributing.md — or visit the Contribute page on the live site.
The short version: add a file, fill in the frontmatter, open a PR.
- Docusaurus 3 — static site framework
- Mermaid — diagrams in markdown
- docusaurus-search-local — offline full-text search
- GitHub Actions + GitHub Pages — CI/CD and hosting