OpenWallet Vietnam

Open-source digital wallet card database for Vietnam. Public card comparison site + local-first wallet manager (IndexedDB, no accounts).

Site: https://openwallet.vn

Quick Start

pnpm install
pnpm dev

Open http://localhost:3000.

Component Browser (Storybook)

pnpm storybook

Open http://localhost:4000. Stories live alongside components as *.stories.tsx. Use /create-story in Claude Code to generate a story for any component.

Published: https://storybook.openwallet.vn

Environment Variables

Create .env.local:

OPENWALLET_API_KEY=your_api_key_here

OPENWALLET_API_KEY is a server-only build secret - never use NEXT_PUBLIC_ prefix.

Deploy

Vercel. SSR/SSG with dynamic routes. Data fetched at build time where possible.

Tech Stack

• Next.js + React
• TypeScript
• Tailwind CSS v4
• Dexie.js (IndexedDB)
• PostHog
• Storybook 10
• pnpm

License

PolyForm Noncommercial 1.0.0 - study and personal use only, no commercial forks.