create-next-app
La CLI create-next-app te permite crear una nueva aplicación Next.js usando la plantilla predeterminada o un ejemplo de un repositorio público de GitHub. Es la forma más fácil de comenzar con Next.js.
Uso básico:
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 Enrutador de App |
--api | Inicializar un proyecto solo con manejadores de ruta |
--src-dir | Inicializar dentro de un directorio src/ |
--turbopack | 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 para inicializar la aplicación |
--example-path <ruta-al-ejemplo> | Especificar la ruta al ejemplo por separado |
--reset-preferences | Restablecer preferencias almacenadas |
--skip-install | Omitir la instalación de 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:
Se te harán las siguientes preguntas:
Después de responder 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. Por 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: