Auth
- ~/lib/session.ts: Session type + loadSession/signIn/signOut/hasSession,
reactive useSession hook (mock backend; replace fetch calls with your
real auth endpoint when ready)
- routes/login.tsx: form with email/password (mock-validated), bounces
to ?next= on success
- AppShell: redirects to /login when no session; account-menu Sign out
now actually signs out; live session.name/email used for the appbar
avatar (falls back to profile)
Notifications
- ~/lib/notifications.ts: persistent inbox with kinds (info/success/
warning/error), unreadCount, markRead, markAllRead, dismiss,
dismissAll; seedIfEmpty for a friendly first-run
- AppShell bell: 320px popover with badge, kind dots, per-row open
(navigates to href) and dismiss; Mark all read + Clear actions
- Hidden NotificationDispatcher in AppShell so the action bus can
create real notifications via fill notif-title / notif-body /
notif-kind / notif-href + click notif-create
Data layer
- ~/lib/api.ts: typed apiFetch<T> + api.get/post/put/patch/del,
auto-attaches the session token, throws structured ApiError, signs
out on 401
- ~/lib/resources.ts: example domain entity (CRUD) backed by
localStorage today; each call is a 1:1 swap for api.get/post/put/del
- routes/resources.tsx: real working table — search, add, inline
status edit, delete; seeded demo rows on first load
Tests
- vitest + jsdom + @testing-library/react + @testing-library/jest-dom
+ vite-tsconfig-paths installed
- vitest.config.ts (jsdom, globals, ~ aliases via tsconfig-paths)
- vitest.setup.ts (RTL cleanup + localStorage clear between tests)
- app/lib/session.test.ts and resources.test.ts as starter coverage
- npm test / npm run test:watch scripts
UI Control catalog
- Login form, resources CRUD, notifications inbox, and the hidden
notif-bridge ids tagged so the assistant can drive every new surface
Threads
- ThreadMessage now carries optional agentId so per-message authorship
survives persona switches and handoffs
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Hybrid traditional + AI-first webapp scaffold. Sibling to crema-app-template,
adds the AI assistant surface, command bus, scripts dialog, and virtual
cursor.
What's pre-wired:
- 6 routes: Overview, Resources, Activity, Assistant, Library, Settings
- Collapsible rail + appbar + avatar dropdown shell (template code, not a lib)
- Mobile sheet at <md
- /assistant: streaming chat via @crema/llm-ui, mock fallback, model selector,
token meter, retry probe, stop-while-streaming, persistent UI Control toggle
- /settings: editable LM Studio endpoint + context window + response cap, with
test-connection button
- Markdown rendering for assistant replies; ```action``` blocks rendered as a
small "Ran N actions" pill
- ⌘⇧P script runner dialog + Play icon in the appbar
- Two demo scripts in public/scripts/
- mightypix theme as default, scoped via <AppShell theme="mightypix">
Libs wired in tsconfig + app.css:
- @crema/action-bus (the bus, parser, runner, cursor, provider, ws, llm-bridge)
- @crema/llm-ui, @crema/chat-ui, @crema/aifirst-ui, @crema/notification-ui
- lib-theme-mightypix
Docs:
- README.md — pitch + quick start + structure
- docs/AI_FIRST.md — full system tour (data-action contract, bus, DSL, scripts,
cursor, LLM integration)
- app/components/layout/THEME_CONTRACT.md — every CSS variable a theme must declare
- CLAUDE.md — orientation for an LLM working in the repo
Genericized from comfy-cloud (the original prototype):
- Brand defaults to "App" / Sparkles icon (override via app/lib/identity.ts)
- User defaults to a stub (swap useUser() for real auth)
- localStorage namespace is "crema.*" (was "comfy.*")
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
