Insight OS
AI-powered analytics SaaS (Frontend MVP) for cross-border e-commerce ops across four
markets — US, JP, TW, DE. Ships EN + 繁體中文.
Stack
Nuxt 4 (app/ dir) · TypeScript · Vue 3 <script setup> · Nuxt UI 4 ·
Tailwind CSS v4 · Pinia · TanStack Vue Query · Apache ECharts (vue-echarts) ·
@nuxtjs/i18n.
- Package manager: pnpm (
pnpm-lock.yaml is committed)
- Node: 24 (see
.nvmrc)
Getting started
pnpm install # runs `nuxt prepare` + husky setup via lifecycle scripts
pnpm dev # http://localhost:3000
Scripts
| Command | What it does |
|---|
pnpm dev | Start the dev server |
pnpm build | Production build (Nitro output) |
pnpm preview | Preview the production build |
pnpm lint | ESLint (flat config via @nuxt/eslint) |
pnpm typecheck | nuxt typecheck (vue-tsc) |
pnpm test | Vitest — unit (Node) + nuxt runtime projects |
pnpm test:e2e | Playwright smoke (not in the blocking CI gate) |
Quality gate
Every PR into main runs lint · typecheck · test · build in GitHub Actions
(.github/workflows/ci.yml). Deployment is owned by Vercel (preview per PR,
production on merge). Local Husky hooks (lint-staged + commitlint) are convenience;
CI is the enforced gate.
Conventions
Project rules and detailed conventions live in .claude/ — CLAUDE.md (charter) and
.claude/skills/ (stack conventions incl. design tokens, mock API contract, i18n, product
spec, testing/CI, DoD & git workflow). .claude/doc/ holds the decision records behind them.
Consult those before adding code.
