Trauma

Trauma is a personal bookmark management app. The product language uses memory for one saved bookmark and memories for the collection.

⚠️ Warning: This is mostly a personal project that I work on in the margins of another project, so please do not expect particularly eager maintenance.

The project is designed as a lightweight local/self-hosted web app: one SolidStart app, one Bun runtime, SQLite for metadata, markdown files for saved content, and git backup for the markdown store.

Status

Foundation feature work is underway. The app has the SolidStart/Bun toolchain, baseline routes, test configuration, Drizzle/SQLite persistence, config loading, markdown content store APIs, and documentation/workflow structure needed for the remaining implementation tasks.

Stack

• TypeScript
• SolidStart / Solid
• Bun
• Drizzle ORM
• SQLite
• Playwright
• Vitest

Pinned bootstrap versions are documented in docs/references/technology-stack.md.

Local Development

Install dependencies:

bun install

Run the dev server:

bun run dev

Run baseline verification:

bun run verify

Run E2E smoke tests:

bun run test:e2e

Documentation

Start with docs/INDEX.md.

Key references:

• Foundation design
• Task execution workflows
• Architecture overview
• Data and storage
• Runtime flows
• UI and routing
• Configuration
• Verification strategy

Initial Scope

Trauma is initially single-user and local/self-hosted. Auth, public signup, managed databases, external queues, serverless deployment, and full offline archival are out of scope for the foundation.