@@ -37,15 +37,18 @@ ls .claude/troubleshooting
3737** Principles** : Simplicity, minimalism, developer-focused aesthetics
3838
3939** Primary Color** : ` #00D372 ` (oklch(76% 0.2 153)) — ut.code(); brand lime green
40+
4041- Use sparingly for emphasis: CTAs, labels, hover states
4142- Background: white (#ffffff) with zinc-50 alternating sections
4243- Text: zinc-900 primary, zinc-500 secondary
4344
4445** Typography** :
46+
4547- Body: DM Sans (clean, modern)
4648- Code/Mono: JetBrains Mono (developer identity)
4749
4850** Key Rules** :
51+
49521 . Content-first: minimal decoration, readability priority
50532 . High contrast: clear visual hierarchy
51543 . Generous spacing: py-24 sections, max-w-6xl containers
@@ -105,6 +108,11 @@ bun lint-check # runs lint check
105108bun format-check # runs format check
106109bun fix # runs all automated fixes (format+lint)
107110bun tidy # runs all automated checks and fixes as necessary (type+format+lint)
111+
112+ # devenv controls
113+ bun up # spin up devenv server (usually already done by user)
114+ bun down # stop it
115+ bun tail # !important tail the logs
108116```
109117
110118# Bun Commands
@@ -131,6 +139,7 @@ run `bun tidy` after you finish your work. i.e. before commit
131139- Never use ` as ` or ` any ` . Let TypeScript infer types properly.
132140- Never just "fire and forget". it crashes the entire server. instead, catch ` .catch(console.error) ` then forget, if you want to dispatch the job.
133141- ** NEVER use ` $derived(await ...) ` in Svelte 5.** This causes infinite loops and memory leaks. Use top-level ` await ` instead:
142+
134143 ``` ts
135144 // ❌ WRONG - causes memory leak
136145 const data = $derived (await fetchData ());
@@ -139,7 +148,7 @@ run `bun tidy` after you finish your work. i.e. before commit
139148 const data = await fetchData ();
140149
141150 // ✅ For reactive dependencies, use $derived without await
142- const filtered = $derived (data .filter (x => x .active ));
151+ const filtered = $derived (data .filter (( x ) => x .active ));
143152 ```
144153
145154For detailed coding standards (import order, async patterns, naming conventions), see ` docs/knowledges/coding-standards.md ` .
0 commit comments