create-next-app
La forma más fácil de comenzar con Next.js es usando create-next-app. Esta herramienta CLI te permite comenzar rápidamente a construir una nueva aplicación Next.js, con todo configurado para ti.
Puedes crear una nueva aplicación usando la plantilla predeterminada de Next.js, o usando uno de los ejemplos oficiales de Next.js.
Interactivo
Puedes crear un nuevo proyecto de forma interactiva ejecutando:
npx create-next-app@latestyarn create next-apppnpm create next-appbunx create-next-appLuego se te harán las siguientes preguntas:
¿Cómo se llamará tu proyecto? mi-app
¿Deseas usar TypeScript? No / Sí
¿Deseas usar ESLint? No / Sí
¿Deseas usar Tailwind CSS? No / Sí
¿Deseas usar el directorio `src/`? No / Sí
¿Deseas usar el Enrutador de App? (recomendado) No / Sí
¿Deseas personalizar el alias de importación predeterminado (@/*)? No / SíUna vez que respondas las preguntas, se creará un nuevo proyecto con la configuración correcta según tus respuestas.
No interactivo
También puedes pasar argumentos por línea de comandos para configurar un nuevo proyecto de forma no interactiva.
Además, puedes negar las opciones predeterminadas anteponiendo --no- (ej. --no-eslint).
Consulta create-next-app --help:
Uso: create-next-app <directorio-del-proyecto> [opciones]
Opciones:
-V, --version muestra el número de versión
--ts, --typescript
Inicializa como proyecto TypeScript. (predeterminado)
--js, --javascript
Inicializa como proyecto JavaScript.
--tailwind
Inicializa con configuración de Tailwind CSS. (predeterminado)
--eslint
Inicializa con configuración de ESLint.
--app
Inicializa como proyecto con Enrutador de App.
--src-dir
Inicializa dentro de un directorio `src/`.
--import-alias <alias-a-configurar>
Especifica el alias de importación a usar (predeterminado "@/*").
--use-npm
Indica explícitamente al CLI que inicie la app usando npm
--use-pnpm
Indica explícitamente al CLI que inicie la app usando pnpm
--use-yarn
Indica explícitamente al CLI que inicie la app usando Yarn
--use-bun
Indica explícitamente al CLI que inicie la app usando Bun
-e, --example [nombre]|[url-github]
Un ejemplo para iniciar la app. Puedes usar un nombre de ejemplo
del repositorio oficial de Next.js o una URL pública de GitHub. La URL puede usar
cualquier rama y/o subdirectorio
--example-path <ruta-al-ejemplo>
En casos raros, tu URL de GitHub podría contener un nombre de rama con
una barra (ej. bug/fix-1) y la ruta al ejemplo (ej. foo/bar).
En este caso, debes especificar la ruta al ejemplo por separado:
--example-path foo/bar
--reset-preferences
Indica explícitamente al CLI que reinicie cualquier preferencia almacenada
-h, --help muestra información de uso¿Por qué usar Create Next App?
create-next-app te permite crear una nueva aplicación Next.js en segundos. Está mantenido oficialmente por los creadores de Next.js e incluye varios beneficios:
- Experiencia interactiva: Ejecutar
npx create-next-app@latest(sin argumentos) inicia una experiencia interactiva que te guía en la configuración del proyecto. - Cero dependencias: Inicializar un proyecto es tan rápido como un segundo. Create Next App no tiene dependencias.
- Soporte sin conexión: Create Next App detectará automáticamente si estás offline y configurará tu proyecto usando la caché local de paquetes.
- Soporte para ejemplos: Create Next App puede configurar tu aplicación usando un ejemplo de la colección de ejemplos de Next.js (ej.
npx create-next-app --example api-routes) o cualquier repositorio público de GitHub. - Probado: El paquete es parte del monorepo de Next.js y se prueba usando el mismo conjunto de pruebas de integración que Next.js mismo, garantizando que funcione como se espera en cada lanzamiento.