chore: wip.

Author: PttCodingMan

.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  backend-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          
+      - name: Set up Python
+        run: uv python install 3.12
+        
+      - name: Install dependencies
+        run: |
+          cd backend
+          uv venv
+          uv pip install -r requirements.txt -r requirements-dev.txt
+          
+      - name: Run tests
+        run: |
+          cd backend
+          source .venv/bin/activate
+          pytest
+
+  frontend-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+          cache-dependency-path: frontend/package-lock.json
+          
+      - name: Install dependencies
+        run: |
+          cd frontend
+          npm ci
+          npm install -D vitest jsdom @testing-library/react @testing-library/jest-dom @testing-library/dom
+          
+      - name: Lint
+        run: |
+          cd frontend
+          npm run lint
+          
+      - name: Run tests
+        run: |
+          cd frontend
+          npm test

.gitignore

@@ -8,3 +8,6 @@ dist/
 .env
 *.egg-info/
 .DS_Store
+.venv*
+*.coverage
+.claude

CLAUDE.md

@@ -0,0 +1,82 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+JustWiki is a lightweight, self-hosted wiki for small teams. Markdown-first, single SQLite file, no external dependencies. Backend is Python/FastAPI, frontend is React/Vite.
+
+## Development Commands
+
+```bash
+make setup          # First-time: install deps (uv + npm), create .env from .env.example
+make dev            # Start backend (port 8000) + frontend (port 5173) concurrently
+make dev-backend    # Backend only: uvicorn with --reload on port 8000
+make dev-frontend   # Frontend only: Vite dev server on port 5173
+make build          # Build frontend for production (vite build)
+make test           # Run all backend and frontend tests
+make test-backend   # Run backend tests with pytest
+make test-frontend  # Run frontend tests with vitest
+make lint           # Run frontend linting
+make backup         # Copy SQLite DB to backup/ with timestamp
+```
+
+Frontend linting: `cd frontend && npm run lint`
+Backend tests location: `backend/tests/`
+Frontend tests location: `frontend/src/**/*.test.{js,jsx}`
+
+## Architecture
+
+### Backend (`backend/app/`)
+
+- **Framework**: FastAPI (async), aiosqlite for SQLite access (WAL mode)
+- **Entry**: `main.py` — app creation, CORS, lifespan hooks, router mounting
+- **Auth**: `auth.py` — JWT tokens in httpOnly cookies, bcrypt passwords, rate-limited login
+- **Config**: `config.py` — Pydantic Settings reading from `.env`
+- **Database**: `database.py` — schema DDL, migrations, FTS5 search index setup
+- **Routers**: One file per domain — `pages.py`, `search.py`, `media.py`, `versions.py`, `tags.py`, `templates.py`, `users.py`, `diagrams.py`, `comments.py`, `bookmarks.py`, `activity.py`, `backup.py`, `export.py`, `auth_router.py`
+- **Services**: `search.py` (FTS5 indexing, CJK segmentation), `wikilink.py` (backlink tracking)
+- **Deps**: Python 3.11+, managed with `uv`
+
+### Frontend (`frontend/src/`)
+
+- **Framework**: React 19, Vite 8, Tailwind CSS 4
+- **State**: Zustand stores in `store/` — one per domain (useAuth, usePages, useTags, useBookmarks, useTheme, useSearch, useActivity)
+- **API client**: `api/client.js` — Axios instance with interceptors, 401 redirect to login
+- **Routing**: React Router v7 in `App.jsx`, PrivateRoute wrapper for auth
+- **Keyboard shortcuts**: `hooks/useKeyboard.jsx` (Ctrl+E edit, Ctrl+K search, etc.)
+
+### Editor and Viewer (dual rendering paths)
+
+These are separate systems with independent rendering logic — changes to one do not affect the other. **Always verify both when modifying markdown-related features.**
+
+- **Editor**: `components/Editor/Editor.jsx` — Milkdown (ProseMirror-based) WYSIWYG editor with slash commands, wikilink autocomplete `[[page]]`, image paste upload, GFM support
+- **Viewer**: `components/Viewer/MarkdownViewer.jsx` — Custom markdown-to-HTML parser (not a library). Handles Mermaid diagrams, KaTeX math (`$$...$$`), callout blocks (`:::info`), wikilinks, tables, nested lists. Sanitized with DOMPurify.
+
+### Database (SQLite, single file at `data/just-wiki.db`)
+
+Key tables: `users`, `pages` (with `parent_id` hierarchy and `slug` URL), `page_versions`, `tags`, `page_tags`, `backlinks`, `templates`, `media`, `diagrams`, `comments`, `bookmarks`, `activity_log`. FTS5 virtual table `search_index` for full-text search with CJK support.
+
+Schema auto-migrates on startup in `database.py`.
+
+### Wikilinks
+
+Format: `[[slug]]` or `[[slug|display text]]`. Parsed on both backend (backlink tracking in `backlinks` table via `services/wikilink.py`) and frontend (navigation in viewer). Slug generation uses `pypinyin` for Chinese characters.
+
+## API Structure
+
+All endpoints under `/api/`. Vite dev server proxies `/api` to `localhost:8000`. Key routes:
+
+- Pages CRUD: `/api/pages`, `/api/pages/{slug}`, `/api/pages/tree`, `/api/pages/graph`
+- Versions: `/api/pages/{slug}/versions`, `/api/pages/{slug}/diff/{v1}/{v2}`
+- Search: `/api/search?q=...`
+- Media upload: `POST /api/media/upload` (20MB limit)
+- Auth: `/api/auth/login`, `/api/auth/me`
+
+## Themes
+
+Multiple built-in themes (light, dark, lavender, forest, etc.) via CSS variables in `frontend/src/index.css`, persisted with Zustand store `useTheme.js`.
+
+## Deployment
+
+Docker Compose: backend (uvicorn, port 8000) + frontend (nginx, port 3000). Shared `./data` volume. All config in `.env`.

Makefile

@@ -1,4 +1,4 @@
-.PHONY: dev dev-backend dev-frontend build backup clean
+.PHONY: dev dev-backend dev-frontend build backup clean test test-backend test-frontend lint
 
 dev:
 	@echo "Starting backend and frontend..."
@@ -25,6 +25,17 @@ clean:
 	rm -rf frontend/dist
 	@echo "Cleaned"
 
+test: test-backend test-frontend
+
+test-backend:
+	cd backend && source .venv/bin/activate && python -m pytest
+
+test-frontend:
+	cd frontend && npm test
+
+lint:
+	cd frontend && npm run lint
+
 docker-up:
 	docker-compose up -d
 
@@ -33,9 +44,9 @@ docker-down:
 
 setup:
 	@echo "Setting up backend..."
-	cd backend && uv venv && source .venv/bin/activate && uv pip install -r requirements.txt
+	cd backend && uv venv && source .venv/bin/activate && uv pip install -r requirements.txt -r requirements-dev.txt
 	@echo "Setting up frontend..."
-	cd frontend && npm install
+	cd frontend && npm install && npm install -D vitest jsdom @testing-library/react @testing-library/jest-dom @testing-library/dom
 	@echo "Creating .env..."
 	cp -n .env.example .env || true
 	@echo "Done! Run 'make dev' to start."

README.md

@@ -13,10 +13,18 @@ A lightweight, self-hosted wiki for small teams. Just clone, run, and write.
 - **Full-text search** — FTS5 powered, with optional AI Q&A (Gemini)
 - **Version history** — page revisions with diff view
 - **Draw.io integration** — embedded diagram editor
-- **Themes** — multiple built-in themes
+- **Themes** — 9 built-in color palettes ([preview](#themes))
 - **PWA ready** — installable on mobile and desktop
 - **Docker support** — `docker-compose up` and done
 
+## Themes
+
+<p align="center">
+  <img src="docs/images/themes.png" alt="9 built-in themes: Light, Dark, Lavender, Forest, Rose, Ocean, Sand, Sunset, Nord" width="100%">
+</p>
+
+Nine curated palettes ship out of the box — **Light, Dark, Lavender, Forest, Rose, Ocean, Sand, Sunset, Nord**. Switch any time from the top-right theme picker; your choice is remembered per browser.
+
 ## Tech Stack
 
 | Layer    | Stack                                          |
@@ -77,6 +85,32 @@ make docker-down    # docker-compose down
 make setup          # First-time setup (install deps, create .env)
 ```
 
+## Slash Commands
+
+<p align="center">
+  <img src="docs/images/slash-commands.png" alt="Type / in the editor to open the slash command menu" width="80%">
+</p>
+
+In the editor, type `/` to open the slash menu. You can filter by typing after the slash.
+
+| Command | Description |
+| ------- | ----------- |
+| `/h1` | Heading 1 — big section heading |
+| `/h2` | Heading 2 — medium section heading |
+| `/h3` | Heading 3 — small section heading |
+| `/bullet` | Bullet List — unordered list |
+| `/ordered` | Ordered List — numbered list |
+| `/quote` | Blockquote — quote block |
+| `/code` | Code Block — code snippet |
+| `/hr` | Divider — horizontal rule |
+| `/callout-info` | Info Callout — `:::info` block |
+| `/callout-warning` | Warning Callout — `:::warning` block |
+| `/callout-tip` | Tip Callout — `:::tip` block |
+| `/callout-danger` | Danger Callout — `:::danger` block |
+| `/mermaid` | Mermaid Diagram — insert mermaid chart |
+| `/math` | Math Formula — KaTeX math block |
+| `/drawio` | Draw.io Diagram — insert Draw.io embed |
+
 ## Project Structure
 
 ```