CLI
La CLI create-next-app te permite crear rápidamente una nueva aplicación Next.js utilizando la plantilla predeterminada o un ejemplo de un repositorio público de Github. Es la forma más sencilla de comenzar con Next.js.
Uso básico:
npx create-next-app@latest [nombre-del-proyecto] [opciones]Referencia
Las siguientes opciones están disponibles:
| Opciones | Descripción |
|---|---|
-h o --help | Mostrar todas las opciones disponibles |
-v o --version | Mostrar el número de versión |
--no-* | Negar opciones predeterminadas. Ej. --no-eslint |
--ts o --typescript | Inicializar como proyecto TypeScript (predeterminado) |
--js o --javascript | Inicializar como proyecto JavaScript |
--tailwind | Inicializar con configuración de Tailwind CSS (predeterminado) |
--eslint | Inicializar con configuración de ESLint |
--app | Inicializar como proyecto con App Router |
--src-dir | Inicializar dentro de un directorio src/ |
--turbo | Habilitar Turbopack por defecto para desarrollo |
--import-alias <alias-a-configurar> | Especificar alias de importación a usar (predeterminado "@/*") |
--empty | Inicializar un proyecto vacío |
--use-npm | Indicar explícitamente a la CLI que use npm |
--use-pnpm | Indicar explícitamente a la CLI que use pnpm |
--use-yarn | Indicar explícitamente a la CLI que use Yarn |
--use-bun | Indicar explícitamente a la CLI que use Bun |
-e o --example [nombre] [url-github] | Ejemplo con el que inicializar la aplicación |
--example-path <ruta-al-ejemplo> | Especificar la ruta al ejemplo por separado |
--reset-preferences | Indicar a la CLI que reinicie preferencias almacenadas |
--skip-install | Indicar a la CLI que omita instalar paquetes |
--yes | Usar preferencias previas o valores predeterminados |
Ejemplos
Con la plantilla predeterminada
Para crear una nueva aplicación usando la plantilla predeterminada, ejecuta el siguiente comando en tu terminal:
npx create-next-app@latestSe te harán las siguientes preguntas:
¿Cómo se llama tu proyecto? mi-app
¿Quieres usar TypeScript? No / Sí
¿Quieres usar ESLint? No / Sí
¿Quieres usar Tailwind CSS? No / Sí
¿Quieres tu código dentro de un directorio `src/`? No / Sí
¿Quieres usar App Router? (recomendado) No / Sí
¿Quieres usar Turbopack para `next dev`? No / Sí
¿Quieres personalizar el alias de importación (`@/*` por defecto)? No / SíUna vez respondidas las preguntas, se creará un nuevo proyecto con tu configuración elegida.
Con un ejemplo oficial de Next.js
Para crear una nueva aplicación usando un ejemplo oficial de Next.js, usa el flag --example con el siguiente comando:
npx create-next-app@latest --example [nombre-de-tu-proyecto] [nombre-del-ejemplo]Puedes ver una lista de todos los ejemplos disponibles junto con instrucciones de configuración en el repositorio de Next.js.
Con cualquier ejemplo público de Github
Para crear una nueva aplicación usando cualquier ejemplo público de Github, usa la opción --example con la URL del repositorio. Por ejemplo:
npx create-next-app@latest --example [nombre-de-tu-proyecto] "https://github.com/.../"