b7ea0a5abe
Following up https://github.com/vercel/next.js/pull/42012 this adds an additional prompt for include ESLint config/dependencies or not. As discussed, this also removes the slow down from doing separate `dependencies` and `devDependencies` installs since this separation is no longer required now that we have `output: 'standalone'` which ensures only actual necessary dependency files are used for production builds. <details> <summary>Before</summary> https://user-images.githubusercontent.com/22380829/198953290-116b422d-4359-4aa9-9d82-b3265fde7b3f.mp4 </details> <details> <summary>After</summary> https://user-images.githubusercontent.com/22380829/198953347-20dbf897-92b3-45ea-a9d2-cfb61622251d.mp4 </details> ## Bug - [ ] Related issues linked using `fixes #number` - [ ] Integration tests added - [ ] Errors have a helpful link attached, see `contributing.md` ## Feature - [ ] Implements an existing feature request or RFC. Make sure the feature request has been accepted for implementation before opening a PR. - [ ] Related issues linked using `fixes #number` - [ ] Integration tests added - [ ] Documentation added - [ ] Telemetry added. In case of a feature if it's used or not. - [ ] Errors have a helpful link attached, see `contributing.md` ## Documentation / Examples - [ ] Make sure the linting passes by running `pnpm build && pnpm lint` - [ ] The "examples guidelines" are followed from [our contributing doc](https://github.com/vercel/next.js/blob/canary/contributing/examples/adding-examples.md)
291 lines
7.2 KiB
JavaScript
291 lines
7.2 KiB
JavaScript
#!/usr/bin/env node
|
|
/* eslint-disable import/no-extraneous-dependencies */
|
|
import chalk from 'chalk'
|
|
import Commander from 'commander'
|
|
import path from 'path'
|
|
import prompts from 'prompts'
|
|
import checkForUpdate from 'update-check'
|
|
import { createApp, DownloadError } from './create-app'
|
|
import { getPkgManager } from './helpers/get-pkg-manager'
|
|
import { validateNpmName } from './helpers/validate-pkg'
|
|
import packageJson from './package.json'
|
|
import ciInfo from 'ci-info'
|
|
|
|
let projectPath: string = ''
|
|
|
|
const program = new Commander.Command(packageJson.name)
|
|
.version(packageJson.version)
|
|
.arguments('<project-directory>')
|
|
.usage(`${chalk.green('<project-directory>')} [options]`)
|
|
.action((name) => {
|
|
projectPath = name
|
|
})
|
|
.option(
|
|
'--ts, --typescript',
|
|
`
|
|
|
|
Initialize as a TypeScript project. (default)
|
|
`
|
|
)
|
|
.option(
|
|
'--js, --javascript',
|
|
`
|
|
|
|
Initialize as a JavaScript project.
|
|
`
|
|
)
|
|
.option(
|
|
'--eslint',
|
|
`
|
|
|
|
Initialize with eslint config.
|
|
`
|
|
)
|
|
.option(
|
|
'--experimental-app',
|
|
`
|
|
|
|
Initialize as a \`app/\` directory project.
|
|
`
|
|
)
|
|
.option(
|
|
'--use-npm',
|
|
`
|
|
|
|
Explicitly tell the CLI to bootstrap the app using npm
|
|
`
|
|
)
|
|
.option(
|
|
'--use-pnpm',
|
|
`
|
|
|
|
Explicitly tell the CLI to bootstrap the app using pnpm
|
|
`
|
|
)
|
|
.option(
|
|
'-e, --example [name]|[github-url]',
|
|
`
|
|
|
|
An example to bootstrap the app with. You can use an example name
|
|
from the official Next.js repo or a GitHub URL. The URL can use
|
|
any branch and/or subdirectory
|
|
`
|
|
)
|
|
.option(
|
|
'--example-path <path-to-example>',
|
|
`
|
|
|
|
In a rare case, your GitHub URL might contain a branch name with
|
|
a slash (e.g. bug/fix-1) and the path to the example (e.g. foo/bar).
|
|
In this case, you must specify the path to the example separately:
|
|
--example-path foo/bar
|
|
`
|
|
)
|
|
.allowUnknownOption()
|
|
.parse(process.argv)
|
|
|
|
const packageManager = !!program.useNpm
|
|
? 'npm'
|
|
: !!program.usePnpm
|
|
? 'pnpm'
|
|
: getPkgManager()
|
|
|
|
async function run(): Promise<void> {
|
|
if (typeof projectPath === 'string') {
|
|
projectPath = projectPath.trim()
|
|
}
|
|
|
|
if (!projectPath) {
|
|
const res = await prompts({
|
|
type: 'text',
|
|
name: 'path',
|
|
message: 'What is your project named?',
|
|
initial: 'my-app',
|
|
validate: (name) => {
|
|
const validation = validateNpmName(path.basename(path.resolve(name)))
|
|
if (validation.valid) {
|
|
return true
|
|
}
|
|
return 'Invalid project name: ' + validation.problems![0]
|
|
},
|
|
})
|
|
|
|
if (typeof res.path === 'string') {
|
|
projectPath = res.path.trim()
|
|
}
|
|
}
|
|
|
|
if (!projectPath) {
|
|
console.log(
|
|
'\nPlease specify the project directory:\n' +
|
|
` ${chalk.cyan(program.name())} ${chalk.green(
|
|
'<project-directory>'
|
|
)}\n` +
|
|
'For example:\n' +
|
|
` ${chalk.cyan(program.name())} ${chalk.green('my-next-app')}\n\n` +
|
|
`Run ${chalk.cyan(`${program.name()} --help`)} to see all options.`
|
|
)
|
|
process.exit(1)
|
|
}
|
|
|
|
const resolvedProjectPath = path.resolve(projectPath)
|
|
const projectName = path.basename(resolvedProjectPath)
|
|
|
|
const { valid, problems } = validateNpmName(projectName)
|
|
if (!valid) {
|
|
console.error(
|
|
`Could not create a project called ${chalk.red(
|
|
`"${projectName}"`
|
|
)} because of npm naming restrictions:`
|
|
)
|
|
|
|
problems!.forEach((p) => console.error(` ${chalk.red.bold('*')} ${p}`))
|
|
process.exit(1)
|
|
}
|
|
|
|
if (program.example === true) {
|
|
console.error(
|
|
'Please provide an example name or url, otherwise remove the example option.'
|
|
)
|
|
process.exit(1)
|
|
}
|
|
|
|
const example = typeof program.example === 'string' && program.example.trim()
|
|
|
|
/**
|
|
* If the user does not provide the necessary flags, prompt them for whether
|
|
* to use TS or JS.
|
|
*/
|
|
if (!example && !program.typescript && !program.javascript) {
|
|
if (ciInfo.isCI) {
|
|
// default to JavaScript in CI as we can't prompt to
|
|
// prevent breaking setup flows
|
|
program.javascript = true
|
|
program.typescript = false
|
|
program.eslint = false
|
|
} else {
|
|
const styledTypeScript = chalk.hex('#007acc')('TypeScript')
|
|
const { typescript } = await prompts(
|
|
{
|
|
type: 'toggle',
|
|
name: 'typescript',
|
|
message: `Would you like to use ${styledTypeScript} with this project?`,
|
|
initial: true,
|
|
active: 'Yes',
|
|
inactive: 'No',
|
|
},
|
|
{
|
|
/**
|
|
* User inputs Ctrl+C or Ctrl+D to exit the prompt. We should close the
|
|
* process and not write to the file system.
|
|
*/
|
|
onCancel: () => {
|
|
console.error('Exiting.')
|
|
process.exit(1)
|
|
},
|
|
}
|
|
)
|
|
|
|
if (!program.eslint) {
|
|
const styledEslint = chalk.hex('#007acc')('ESLint')
|
|
const { eslint } = await prompts({
|
|
type: 'toggle',
|
|
name: 'eslint',
|
|
message: `Would you like to use ${styledEslint} with this project?`,
|
|
initial: false,
|
|
active: 'Yes',
|
|
inactive: 'No',
|
|
})
|
|
program.eslint = Boolean(eslint)
|
|
}
|
|
/**
|
|
* Depending on the prompt response, set the appropriate program flags.
|
|
*/
|
|
program.typescript = Boolean(typescript)
|
|
program.javascript = !Boolean(typescript)
|
|
}
|
|
}
|
|
|
|
try {
|
|
await createApp({
|
|
appPath: resolvedProjectPath,
|
|
packageManager,
|
|
example: example && example !== 'default' ? example : undefined,
|
|
examplePath: program.examplePath,
|
|
typescript: program.typescript,
|
|
eslint: program.eslint,
|
|
experimentalApp: program.experimentalApp,
|
|
})
|
|
} catch (reason) {
|
|
if (!(reason instanceof DownloadError)) {
|
|
throw reason
|
|
}
|
|
|
|
const res = await prompts({
|
|
type: 'confirm',
|
|
name: 'builtin',
|
|
message:
|
|
`Could not download "${example}" because of a connectivity issue between your machine and GitHub.\n` +
|
|
`Do you want to use the default template instead?`,
|
|
initial: true,
|
|
})
|
|
if (!res.builtin) {
|
|
throw reason
|
|
}
|
|
|
|
await createApp({
|
|
appPath: resolvedProjectPath,
|
|
packageManager,
|
|
typescript: program.typescript,
|
|
eslint: program.eslint,
|
|
experimentalApp: program.experimentalApp,
|
|
})
|
|
}
|
|
}
|
|
|
|
const update = checkForUpdate(packageJson).catch(() => null)
|
|
|
|
async function notifyUpdate(): Promise<void> {
|
|
try {
|
|
const res = await update
|
|
if (res?.latest) {
|
|
const updateMessage =
|
|
packageManager === 'yarn'
|
|
? 'yarn global add create-next-app'
|
|
: packageManager === 'pnpm'
|
|
? 'pnpm add -g create-next-app'
|
|
: 'npm i -g create-next-app'
|
|
|
|
console.log(
|
|
chalk.yellow.bold('A new version of `create-next-app` is available!') +
|
|
'\n' +
|
|
'You can update by running: ' +
|
|
chalk.cyan(updateMessage) +
|
|
'\n'
|
|
)
|
|
}
|
|
process.exit()
|
|
} catch {
|
|
// ignore error
|
|
}
|
|
}
|
|
|
|
run()
|
|
.then(notifyUpdate)
|
|
.catch(async (reason) => {
|
|
console.log()
|
|
console.log('Aborting installation.')
|
|
if (reason.command) {
|
|
console.log(` ${chalk.cyan(reason.command)} has failed.`)
|
|
} else {
|
|
console.log(
|
|
chalk.red('Unexpected error. Please report it as a bug:') + '\n',
|
|
reason
|
|
)
|
|
}
|
|
console.log()
|
|
|
|
await notifyUpdate()
|
|
|
|
process.exit(1)
|
|
})
|