create-aphex 0.3.1 → 0.3.2

package/README.md

@@ -13,13 +13,15 @@ npm create aphex my-app
 npx create-aphex my-app
 ```
 
-You can also invoke it through the [`aphx`](https://www.npmjs.com/package/aphx)
-CLI, which shells out to this package:
+Pick a template with `--template`:
 
 ```bash
-aphx create my-site --template website
+npm create aphex@latest my-site --template website
 ```
 
+`base` (the default) is a minimal starter; `website` is a working marketing site
+with a page builder, blog, forms and SEO.
+
 ## What it does
 
 1. Prompts for a project name (or takes the positional argument).

package/dist/index.js

@@ -6,6 +6,8 @@ import pc from 'picocolors';
 import { downloadTemplate } from 'giget';
 import { parseArgs, templates } from './options.js';
 import { withGeneratedAuthSecret } from './env.js';
+/** Shown as the prompt's placeholder and used when the answer is left empty. */
+const DEFAULT_PROJECT_NAME = 'my-aphex-project';
 async function main() {
     const cliOptions = parseArgs(process.argv.slice(2));
     if (cliOptions.help) {
@@ -22,8 +24,16 @@ async function main() {
     const projectName = cliOptions.projectName ??
         (await p.text({
             message: 'What is your project name?',
-            placeholder: 'my-aphex-project',
-            validate: validateProjectName
+            placeholder: DEFAULT_PROJECT_NAME,
+            // `placeholder` only greys out a hint; `defaultValue` is what an empty
+            // submit actually resolves to. Both, or pressing enter on the suggestion
+            // the prompt just showed you is an error.
+            defaultValue: DEFAULT_PROJECT_NAME,
+            // And `defaultValue` alone isn't enough: clack validates on enter and only
+            // substitutes the default afterwards, so a validator that rejects "" fires
+            // first and the default is never reached. Let empty through here — the
+            // substituted value is checked below, along with the `--` argument path.
+            validate: (value) => (value ? validateProjectName(value) : undefined)
         }));
     if (p.isCancel(projectName)) {
         p.cancel('Operation cancelled');
@@ -92,8 +102,24 @@ async function main() {
             writeFileSync(envPath, withGeneratedAuthSecret(readFileSync(envExamplePath, 'utf-8')));
         }
         spinner.stop('Project created successfully!');
-        const nextSteps = [`cd ${options.projectName}`, 'pnpm install', 'pnpm dev'];
+        const nextSteps = [
+            `cd ${options.projectName}`,
+            'pnpm install',
+            'pnpm dev',
+            '',
+            pc.dim('Then open http://localhost:5173/admin — the first account you'),
+            pc.dim('create becomes the super admin.')
+        ];
         p.note(nextSteps.join('\n'), 'Next steps');
+        // The one thing that silently breaks a fresh project. `.env` pins AUTH_URL to
+        // port 5173, but Vite moves to 5174 when 5173 is taken — and Better Auth
+        // declines any request whose origin doesn't match, as a bare 404 from
+        // /api/auth/* with nothing in the log. The symptom is "sign-up does nothing",
+        // which is unguessable if you haven't been told. Cheap to say here; expensive
+        // to discover.
+        p.log.warn(`${pc.bold('If Vite starts on a port other than 5173')} (because it was taken), update\n` +
+            `${pc.cyan('AUTH_URL')} and ${pc.cyan('AUTH_TRUSTED_ORIGINS')} in ${pc.cyan('.env')} to match, or sign-in\n` +
+            `fails with a bare 404. Same when you deploy: set them to your real URL.`);
         p.outro(pc.green('Your Aphex CMS project is ready! Check out the README.md for more information.'));
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-aphex",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Scaffold a new Aphex CMS project — invoked via `pnpm create aphex`",
   "publishConfig": {
     "provenance": true