Showcase notes (local + hosted)

Small demo vault so new users see inbox, projects, areas, tags, dates, and typical Markdown in the Hub list and note panel.

Self-hosted (disk vault)

The folder vault/showcase/ in the repo is part of the default vault layout. If config/local.yaml points vault_path at the repo vault/, open the Hub and browse showcase/ in the tree—no script required.

Run npm run index if you want those notes included in semantic search.

Hosted (canister, empty new account)

There is no in-app “load demo notes” button yet; onboarding points users to + New note, Import, or the CLI seed below. A future Hub endpoint would need auth, quotas, and abuse review before wrapping this upload path.

Hosted storage is per user on the canister, so new accounts do not see your local vault/ folder. After you sign in once:

cd /path/to/knowtation
KNOWTATION_HUB_URL="https://YOUR-GATEWAY.example" \
KNOWTATION_HUB_TOKEN="PASTE_JWT_HERE" \
npm run seed:hosted-showcase

• JWT: Browser devtools → Application → Local Storage → hub_token, or copy from the post-login URL hash #token=... (Phase 3.1 changed the OAuth redirect from ?token= query param to #token= URL fragment).
• Multi-vault: set KNOWTATION_VAULT_ID if you use a non-default vault (default is default).

The script uploads every .md under vault/showcase/ with the same paths (e.g. showcase/inbox/quick-capture.md). Re-running overwrites note content for those paths.

Starter vault templates

Eight domain templates live under vault/templates/. Each has a README and 5+ example notes with proper frontmatter. Seed any of them into a hosted vault:

npm run seed:template-research-lab
npm run seed:template-business-ops
npm run seed:template-finance
npm run seed:template-engineering-team
npm run seed:template-personal-knowledge
npm run seed:template-smart-home
npm run seed:template-content-creation
npm run seed:template-education

Templates complement agent skill packs and MCP prompts. See TEMPLATES-AND-SKILLS.md for the full architecture.

Other seed scripts

• scripts/seed-hosted-c-data.mjs — older, C-themed notes under seed/c-data/ (still valid if you prefer that namespace).
• scripts/seed-vault-dir-to-hub.mjs — used by npm run seed:hosted-showcase; pass an optional second argument or KNOWTATION_SEED_DIR to upload a different subfolder of vault/.

Proposals / Suggested

Showcase content is notes only. Proposals (Suggested / review flow) appear when agents or the UI create them; seeding proposals would need a separate small script against POST /api/v1/proposals if you want demo rows there later.