Imported from hieudoanm/hieudoanm.github.io (
packages/app/hybrid/shopping/store/AGENTS.md). Install upstream withnpx skills add hieudoanm/hieudoanm.github.io --skill store. Copyright stays with the author.
Store
Apps Store — browse and download all hybrid and native apps. OS detection, recommended downloads, and detail pages. Next.js 16 + React 19 + Tailwind CSS 4 (DaisyUI 5) desktop/web app packaged with Tauri 2.
Documentation
Reference docs live in docs/:
| Doc | Covers |
|---|---|
docs/ARCHITECTURE.md |
Tech stack, directory structure, routing, state management |
docs/ROADMAP.md |
Phased feature roadmap with progress tracking |
docs/CONTRIBUTING.md |
Setup, dev commands, coding and testing conventions |
docs/PACKAGING.md |
Packaging checklist per platform |
docs/DOWNLOADS.md |
Download links per platform |
docs/FEATURES.md |
Feature descriptions and capabilities |
Key Conventions
- Arrow functions for all function declarations and component exports
FCtype for components@/*path aliases- DaisyUI component classes (
btn,card,badge,input,join) - Dark theme as default (
data-theme="nothing"on<html>) prettier-plugin-tailwindcssfor class sorting- Emoji icons via
StoreCard'sICON_EMOJImap (no runtime icon library) - OS detection is client-only — always wrapped in
useEffect parseDownloads()converts raw JSON sections toAppData[]generateStaticParamsrequired for all dynamic routes (output: export)- Store has its own copy of
downloads.json(and its per-section source CSVs insrc/data/csv/) — not cross-package
Commands
pnpm dev # Next.js dev server (Turbopack)
pnpm build # Static export to out/
pnpm test # Jest unit tests (--passWithNoTests)
pnpm test:e2e # Playwright e2e tests
pnpm lint # ESLint with fixes
pnpm format # Prettier
pnpm tauri dev|build # Desktop app via Tauri CLIStructure
src/app/ # App Router pages (61 app detail pages + info routes)
src/components/
organisms/ # Header
templates/ # About/Version/NotFound/Error templates
StoreCard.tsx # App card component
AppPage.tsx # Detail page wrapper
AppInfo.tsx # Detail view component
src/data/
downloads.json # App catalog (61 apps)
csv/ # Source data (per-section CSV files)
scripts/ # CSV → JSON converter
src/lib/
os.ts # Platform detection
downloads.ts # Data parser with platform logic
src/styles/ # globals.css, base.css, themes.css
public/ # manifest.json, sw.js
e2e/ # Playwright specsRoutes
/— home with search, filter tabs, app grid/app/[slug]— app detail page (61 static pages)/about— about the store/version— changelog