@undp/create-app is UNDPβs official project scaffolding tool for quickly bootstrapping frontend applications using React, and TypeScript β complete with sensible defaults for Biome.
- βοΈ React + TypeScript setup out of the box
- ποΈ Includes Tailwind CSS for styling
- ποΈ Includes Zustand for state management
- π Vite support for fast SPA development, including optional routing with Tanstack router
- π Next.js support for full-stack apps, including optional authentication with Better Auth
- π¨ Preconfigured for UNDPβs Design System
- β‘οΈ Optional integration with Tanstack query for data fetching
- π Optional integration with @undp/data-viz for interactive data visualization
- π£ Optional integration with i18next for internationalization
- β¨ Biome preconfigured for consistent code style
All setups include Tailwind CSS for styling and Zustand for state management.
| Framework | Variants | Description | Internationalization Available |
|---|---|---|---|
| Vite β Recommended | Basic | Minimal React + TypeScript setup | β |
| Vite β Recommended | + Router | Adds TanStack Router for routing | β |
| Next.js | Basic | SSR and file-based routing | β |
| Next.js | + Auth | Includes authentication via Better Auth | β |
Note: Vite is the primary focus of this scaffolding. Its setups are the most mature and feature-complete, including i18n support. The Next.js setups are more experimental and may lag behind.
You donβt need to install it globally β just use npx:
npx @undp/create-app my-undp-appAfter running the CLI, navigate into your project and start the dev server:
cd my-undp-app && npm run devPlease note: If you have not installed the dependencies then you might want to run npm install before npm run dev.
Please note: The scaffolding tool installs Proxima Nova and Sonhe Breit fonts; you can only use these fonts if you have a license or are using the app as UNDP sub-domain.