Skip to content

technology-stack.md

Latest commit

 

History

History
82 lines (62 loc) · 2.8 KB

technology-stack.md

File metadata and controls

82 lines (62 loc) · 2.8 KB
Raw

Technology Stack Reference

This reference records the selected current stack and explicit exclusions.

Selected Stack

  • Language: TypeScript.
  • Framework: SolidStart.
  • UI library: Solid.
  • Styling: Tailwind CSS through the Vite plugin.
  • Runtime and package manager: Bun.
  • ORM: Drizzle ORM.
  • Database: SQLite through Drizzle's Bun SQLite support.
  • Web content extraction: Defuddle with linkedom for server-side DOM parsing.
  • Browser-assisted import: local Chrome Manifest V3 extension built with Bun.
  • Optional AI backend transport: a separately operated Codex app-server over its Unix listener.
  • Unit/integration testing: Vitest.
  • E2E testing: Playwright.

Current Bootstrap Pins

  • Bun: 1.3.13 through mise.toml and packageManager.
  • SolidStart: stable v1 starter, currently @solidjs/start@1.3.2.
  • Build runner: vinxi.
  • Tailwind CSS: v4 through @tailwindcss/vite.

Package Manager Rules

Bun is the only package manager for this project.

  • Commit and review bun.lock.
  • Use bun install for dependency installation.
  • Use frozen lockfile installs in CI once dependencies are already resolved.
  • Do not add npm, Yarn, or pnpm lockfiles.

Styling Rules

Tailwind CSS is the active styling system.

  • Treat the design system reference as the owning documentation for token, shell, component, icon, and visual verification rules.
  • Use Tailwind v4 through @tailwindcss/vite in app.config.ts.
  • Keep src/styles/tailwind.css as the only global stylesheet entry.
  • Do not reintroduce src/styles/app.css.
  • Put ordinary component styling on JSX as static Tailwind class strings or Solid classList entries.
  • Use @tailwindcss/typography for rendered markdown reader content.
  • Keep narrow arbitrary selectors only for markup that cannot be authored directly, such as sanitized markdown HTML.

Deployment Target

The app targets local operation and single-instance self-hosting on a VPS or home server with persistent disk.

This is not a serverless-first application.

Rationale

SolidStart keeps routing, SSR, server functions, and UI in one lightweight app. Bun keeps the runtime/package manager surface small. SQLite and the file-backed memory store keep operational cost low and work naturally with one persistent disk.

Drizzle is used to keep the schema and query layer type-safe while remaining close to SQL.

Exclusions

Do not introduce these into the current architecture without an explicit design change:

  • Next.js.
  • PostgreSQL or managed database services.
  • Redis or external job queues.
  • Serverless/edge-only deployment assumptions.
  • React-specific component or routing assumptions.
  • TRAUMA user accounts, browser sessions, public signup, or multi-user ownership. Codex app-server login is an integration credential, not product user authentication.