@undp/create-app

中文文档
0.91.3发布于 2026/11/03ISCES Module

UNDP's project scaffolding tool

原始使用文档
文档目录4 节
  1. 🚀 Features
  2. 🧩 Pre-configured setups
  3. 📦 Installation
  4. 📦 Getting started

🏗️ UNDP Create App CLI npm

@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.

NPM Package


🚀 Features

  • ⚛️ 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

🧩 Pre-configured setups

All setups include Tailwind CSS for styling and Zustand for state management.

FrameworkVariantsDescriptionInternationalization Available
Vite ⭐ RecommendedBasicMinimal React + TypeScript setup✅
Vite ⭐ Recommended+ RouterAdds TanStack Router for routing✅
Next.jsBasicSSR and file-based routing❌
Next.js+ AuthIncludes 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.


📦 Installation

You don’t need to install it globally — just use npx:

npx @undp/create-app my-undp-app

📦 Getting started

After running the CLI, navigate into your project and start the dev server:

cd my-undp-app && npm run dev

Please 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.

版本与发布记录

@undp/create-app 共发布 37 个版本,首次发布于 2025/11/06;过去 12 个月发布了 37 个版本。

版本发布日期距今
0.91.3latest2026/11/03今天
0.91.22026/11/02今天
0.91.12026/11/021 天前
0.91.02026/11/021 天前
0.9.02026/10/0727 天前
0.8.02026/09/111 个月前

关于 @undp/create-app 的常见问题

@undp/create-app 是什么?

开发计划署的项目脚手架工具

如何安装 @undp/create-app?

在项目目录运行 npm install @undp/create-app,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 create-undp-app,可以用 npx create-undp-app 直接运行。

@undp/create-app 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/undp__create-app 是否存在。

@undp/create-app 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@undp/create-app 可以商用吗?

@undp/create-app 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@undp/create-app 还在维护吗?

最新版本 0.91.3 发布于 2026/11/03(今天);至今共发布 37 个版本,其中过去 12 个月发布了 37 个;首次发布于 2025/11/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。