Add game UI panels, keyboard shortcuts, docs narrative overhaul, and unified dev script

- Add MiniStarMap, NpcMarketPanel, ShipStatusPanel, useKeyboardShortcuts
- Add progress bars for approach/mining operations and cargo fill indicator
- Rewrite docs from spreadsheet-first to exploration-first open-world RPG
- Replace dev:db + dev:standalone with unified dev script (scripts/dev.sh)
- Add Vite chunk splitting for three.js and spacetimedb
- Fix displayName dependency in useSpacetimeConnection
- Remove stale usePlayerSession.ts
- Add AGENTS.md files across all packages
This commit is contained in:
2026-06-02 17:32:15 -04:00
parent be8967d5fe
commit 7c93b8a1ae
40 changed files with 2263 additions and 266 deletions

31
packages/ui/AGENTS.md Normal file
View File

@@ -0,0 +1,31 @@
# packages/ui — Shared UI Primitives & Design Tokens
Package: `@void-nav/ui`
Exports: `Button`, `Panel` components and a CSS design token system.
## Structure
```
src/
index.ts Barrel export: Button, Panel
primitives/
Button.tsx Button component with variant support
Panel.tsx Panel/card container component
styles.css Design tokens (dark space theme)
```
## Design Tokens
The CSS file in `src/styles.css` defines the visual identity of the entire project:
- **15 color tokens** — dark space palette (bg, fg, surface, accent, cyan, green, purple, red, muted, border)
- **3 font stacks** — display (Space Grotesk), body (Inter), mono (JetBrains Mono)
- **Border radius**, spacing, and shadow scales
These tokens are imported by `apps/game` and `apps/site` via Tailwind CSS `@import`.
## Conventions
- Components are minimal — they define structure, not complex behavior
- No external dependencies beyond React peer dependency
- Styles use CSS custom properties, not Tailwind classes directly (consumers apply Tailwind)