example-react

@sankyu/react-circle-flags | Example App

React demo app for @sankyu/react-circle-flags.

Live Demo

What's Included

• Named flag imports for tree-shaking friendly usage
• Dynamic flag rendering with runtime country codes
• Build metadata panel
• Reusable browse/grid UI from shared example modules

Prerequisites

• Node.js 20.19+ (recommended by current Vite/Rolldown toolchain)
• npm 10+

Quick Start

# from repo root
npm install
npm run dev

Common Commands

# development
npm run dev

# type-check + production build
npm run build

# preview built app
npm run preview

Key Files

• App entry: examples/example-react/src/App.tsx
• Shared module entry: examples/example-react/src/libs/shared/index.ts
• Flag grid UI: examples/example-react/src/components/FlagGrid.tsx
• Build info UI: examples/example-react/src/components/BuildInfoCard.tsx

StackBlitz Notes

• This example is configured for StackBlitz auto-install.
• If install is interrupted, run npm install once, then npm run dev.