Files
Shade/packages/shade-cli/templates/bun-server
Sterister 518dc68c4f
Some checks failed
Test / test (push) Has been cancelled
feat(cli): M-Tool 1-3 — CLI, templates, Gitea publishing pipeline
Phase B complete: Shade now has a full developer tooling story.

@shade/cli
- shade init with project scaffolding from templates
- shade fingerprint (own or peer)
- shade publish (re-upload bundle)
- shade rotate (--identity for full rotation, otherwise signed prekey)
- shade peer add/list/verify/remove
- shade dashboard (opens observer in browser)
- shade doctor (diagnose config, storage, prekey server reachability)
- Config from .shaderc.json or SHADE_* env vars

Templates (in packages/shade-cli/templates/)
- bun-server — Bun + Hono backend with /send + /receive endpoints
- chat-demo — Two-process Alice/Bob chat over HTTP

Publishing pipeline (Gitea npm registry)
- .gitea/workflows/test.yml — CI on push/PR with PostgreSQL service
- .gitea/workflows/publish.yml — publish on git tag v*
- scripts/publish-all.ts — local publish helper with DRY_RUN support
- scripts/bump-version.ts — lockstep version bump across all packages
- Root package.json scripts: version, publish:dry, publish:all

Also: /health endpoint now lives in createPrekeyRoutes so doctor can
probe it without needing the full standalone setup.

Dry-run verified: all 11 packages pack cleanly.
246 tests passing, 0 failures.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-11 00:38:00 +02:00
..

PROJECT_NAME

A Shade-enabled Bun + Hono server. Encrypted messages in/out via two HTTP endpoints.

Prerequisites

A running Shade prekey server. The default is __PREKEY_SERVER__. You can either:

  • Run one locally: docker run -p 3900:3900 shade-prekey-server
  • Override with SHADE_PREKEY_SERVER=... in .env

Run

bun install
bun run start

The server registers itself with the prekey server on startup.

Endpoints

Send an encrypted message

curl -X POST http://localhost:3000/send \
  -H "Content-Type: application/json" \
  -d '{"to": "peer-name", "message": "hello"}'

Returns a ShadeEnvelope you can forward to the peer via any transport.

Receive an encrypted envelope

curl -X POST http://localhost:3000/receive \
  -H "Content-Type: application/json" \
  -d '{"from": "peer-name", "envelope": {...}}'

Returns the decrypted plaintext.

Next steps

  • Wire a real delivery layer (WebSocket, HTTP push, etc.)
  • Run shade dashboard to watch live activity
  • Compare fingerprints with peers out-of-band before trusting sessions