Tech Stack

Supershyft OS is built on modern, scalable technologies optimized for edge computing.

Frontend

Core: Vue 3 Composition API, TypeScript, Vite

UI: shadcn-vue, Tailwind CSS v3, lucide-vue-next, Inter font

Data: TanStack Vue Table, Vue Router 4

Architecture:

• views/: 9 route pages (Login, Home, Companies, CompanyDetail, Theses, Dealflow, Activity, Workers, Profile)
• components/: 5 shared + shadcn-vue UI library
• composables/: 4 state hooks (User, Search, Pagination, BulkActions)
• lib/: Formatters, constants, utils

Backend

Workers: Hono framework, edge compute, zero cold starts

Data: D1 (SQLite) ✅, R2 (object storage) ✅, Vectorize (embeddings) ✅

AI: Workers AI ✅, Queues ✅, bulk parallel processing

Auth: Google OAuth 2.0 ✅, JWT session management ✅

Monorepo Structure

supershyft-os/
├── apps/
│   ├── web/              # Vue SPA (port 5173)
│   ├── api-worker/       # API worker (port 8787)
│   ├── ai-worker/        # AI job worker (port 8788)
│   └── docs/             # VitePress documentation
├── packages/
│   └── shared/           # Shared types and utilities
└── scripts/
    └── data/             # Database and import scripts

Development

Tools: pnpm, Wrangler CLI, Node v20 (.nvmrc)

Commands: pnpm dev:all, pnpm build:web, pnpm deploy:api

Deployment

Frontend: Cloudflare Pages (auto-deploy from GitHub) → os.supershyft.capital

Backend: Workers (manual), D1/R2 bindings

Integrations

Linear: Feedback submission, API key in .dev.vars

GitHub: CI/CD, repo lwzlwz/supershyft-os

Principles

Edge-first, serverless, type-safe, component-driven, minimal UI

Performance

TTI < 1s, FCP < 500ms, API < 50ms (edge), Vite code splitting

Scalability

Workers auto-scale, D1 regional replication (coming), Queues with backpressure, R2 unlimited storage