Add @remix-run/create script

This commit separates the `create-remix` script into 2 pieces: the
`create-remix` piece is responsible for creating the app directory and
setting up npm auth. Then it delegates to `@remix-run/create` to install
the templates and `package.json`.

This is really an elaborate workaround for the fact that npm caches
init scripts heavily and we need a way to run the latest version easily.

package.json

@@ -14,6 +14,7 @@
     "packages/create-remix",
     "packages/remix",
     "packages/remix-architect",
+    "packages/remix-create",
     "packages/remix-dev",
     "packages/remix-express",
     "packages/remix-node",

packages/create-remix/README.md

@@ -1,6 +1,7 @@
 # Welcome to Remix!
 
-[Remix](https://remix.run) is a web framework that helps you build better websites with React.
+[Remix](https://remix.run) is a web framework that helps you build better
+websites with React.
 
 To get started, open a new shell and run:
 
@@ -11,3 +12,10 @@ $ npm init remix
 Then follow the prompts you see in your terminal.
 
 For more information about Remix, [visit remix.run](https://remix.run)!
+
+## Note on Versioning
+
+Both `npm init remix` and `npx create-remix` cache scripts aggressively, so in
+order to run the latest version of this script, you'll need to use
+`npx create-remix@latest`. For this reason, this script is versioned
+separately from the rest of Remix and almost never updated.

packages/create-remix/cli.ts

@@ -0,0 +1,164 @@
+import * as path from "path";
+import { execSync } from "child_process";
+import { homedir } from "os";
+import chalkAnimation from "chalk-animation";
+import fse from "fs-extra";
+import inquirer from "inquirer";
+import meow from "meow";
+
+/*
+IMPORTANT: DO NOT MAKE CHANGES to this script unless absolutely necessary!
+
+`npm init remix` and `npx create-remix` both aggressively cache scripts, which
+means that in order to run the latest version of this script they need to use
+`npx create-remix@latest`. There is no way to specify the script version with
+`npm init remix`. So the best user experience is to just never update this
+script so we don't have to tell users to purge their cached versions of it.
+*/
+
+const help = `
+  Create a new Remix app.
+
+  Usage:
+    $ npm init remix -- [flags...] [<dir>]
+    $ npx create-remix [flags...] [<dir>]
+
+  Flags:
+    --auth              Your Remix license key. May be provided up front to avoid
+                        a prompt later if the script is not able to automatically
+                        detect it on this machine. Defaults to using the value of
+                        the REMIX_TOKEN environment variable or the auth token in
+                        $HOME/.npmrc
+    --tag               The version tag of Remix to use. Defaults to "latest"
+    --help, -h          Show this help message
+    --version, -v       Show the version of this script
+`;
+
+run().then(
+  () => {
+    process.exit(0);
+  },
+  error => {
+    console.error(error);
+    process.exit(1);
+  }
+);
+
+async function run() {
+  let { input, flags, showHelp, showVersion } = meow(help, {
+    flags: {
+      auth: { type: "string" },
+      help: { type: "boolean", default: false, alias: "h" },
+      tag: { type: "string", default: "latest" },
+      version: { type: "string", alias: "v" }
+    }
+  });
+
+  if (flags.help) showHelp();
+  if (flags.version) showVersion();
+
+  let anim = chalkAnimation.rainbow(`\nR E M I X\n`);
+  await new Promise(res => setTimeout(res, 1500));
+  anim.stop();
+
+  console.log(
+    "\n💿 Welcome to Remix! Let's get you set up with a new project.\n"
+  );
+
+  // Figure out the app directory
+  let appDir = path.resolve(
+    process.cwd(),
+    input.length > 0
+      ? input[0]
+      : (
+          await inquirer.prompt([
+            {
+              type: "input",
+              name: "dir",
+              message: "Where would you like to create your app?",
+              default: "./my-remix-app"
+            }
+          ])
+        ).dir
+  );
+
+  // Create the app directory
+  if (fse.existsSync(appDir)) {
+    console.log(
+      `️🚨 Oops, "${appDir}" already exists. Please try again with a different directory.`
+    );
+    process.exit(1);
+  } else {
+    await fse.mkdir(appDir);
+  }
+
+  // Make sure npm auth is configured
+  if (process.env.REMIX_TOKEN) {
+    console.log("💿 Detected REMIX_TOKEN on env, using local .npmrc");
+    await writeEnvNpmrc(appDir);
+  } else {
+    if (await hasHomeNpmAuthToken()) {
+      console.log("💿 Detected Remix license in ~/.npmrc");
+    } else {
+      await writeHomeNpmrc(
+        (
+          await inquirer.prompt([
+            {
+              type: "input",
+              name: "key",
+              message:
+                "What is your Remix license key (https://remix.run/dashboard)?"
+            }
+          ])
+        ).key
+      );
+      console.log(
+        `💿 Wrote Remix token to ~/.npmrc. You won't need to provide that next time.`
+      );
+    }
+  }
+
+  // Finish up with @remix-run/create at the right version
+  execSync(`npx --yes @remix-run/create@${flags.tag}`, {
+    stdio: "inherit",
+    cwd: appDir
+  });
+
+  console.log(
+    `💿 That's it! \`cd\` into "${path.relative(
+      process.cwd(),
+      appDir
+    )}" and check the README for development and deploy instructions!`
+  );
+}
+
+async function hasHomeNpmAuthToken(): Promise<boolean> {
+  let npmrcFile = path.resolve(homedir(), ".npmrc");
+  if (fse.existsSync(npmrcFile)) {
+    let npmrc = (await fse.readFile(npmrcFile)).toString();
+    return /\/\/npm\.remix\.run\/:_authToken=/.test(npmrc);
+  }
+  return false;
+}
+
+async function writeHomeNpmrc(token: string): Promise<void> {
+  let npmrc = `
+//npm.remix.run/:_authToken=${token}
+@remix-run:registry=https://npm.remix.run
+`;
+  let npmrcFile = path.resolve(homedir(), ".npmrc");
+  if (fse.existsSync(npmrcFile)) {
+    let existing = await fse.readFile(npmrcFile);
+    npmrc = `${existing}${npmrc}`;
+  }
+  return fse.writeFile(npmrcFile, npmrc.trim());
+}
+
+async function writeEnvNpmrc(dir: string): Promise<void> {
+  let npmrc = `
+//npm.remix.run/:_authToken=\${REMIX_TOKEN}
+@remix-run:registry=https://npm.remix.run
+`;
+  let npmrcFile = path.resolve(dir, ".npmrc");
+  return fse.writeFile(npmrcFile, npmrc.trim());
+}