create-newt-app 0.35.5 → 0.35.6

package/dist/index.js

@@ -11,7 +11,7 @@ import { existsSync, promises, readdirSync } from "fs";
 import path from "path";
 import https from "node:https";
 //#region package.json
-var version = "0.35.5";
+var version = "0.35.6";
 var engines = { "node": ">=24.0.0" };
 //#endregion
 //#region src/templates/root/index.ts
@@ -177,44 +177,71 @@ pnpm dev
 \`\`\`
 
 Open [http://localhost:3000](http://localhost:3000).
-<% if (deployment === 'spa') { -%>
+<% if (deployment === 'none') { -%>
 
-## Production build
+## Production
+
+\`\`\`sh
+pnpm db:migrate && pnpm build
+pnpm --filter @<%= projectName %>/web start
+\`\`\`
+
+Open [http://localhost:3000](http://localhost:3000).
+<% } else if (deployment === 'spa') { -%>
+
+## Production
 
 NestJS serves the static export and the API from one origin, so point \`BETTER_AUTH_URL\` at it:
 
 \`\`\`sh
-pnpm db:migrate
-pnpm build
+pnpm db:migrate && pnpm build
 cd apps/api
 BETTER_AUTH_URL=http://localhost:3001 pnpm start:prod
 \`\`\`
 
 Open [http://localhost:3001](http://localhost:3001). In a real deployment, set \`BETTER_AUTH_URL\` to the public URL.
+<% } else if (deployment === 'standalone') { -%>
+
+## Production
+
+\`\`\`sh
+docker compose up --build
+\`\`\`
+
+The \`migrate\` service applies migrations before the app starts. Open [http://localhost:3000](http://localhost:3000); set \`BETTER_AUTH_URL\` to the public URL in a real deployment.
 <% } -%>
 
-## Apps
+## Commands
 
-- **web**: Next.js frontend (port 3000)
+- \`pnpm dev\`: run in development
+- \`pnpm build\`, \`pnpm typecheck\`, \`pnpm test\`: build, type-check, and test every workspace
+- \`pnpm lint:check\`: lint (fails on errors); \`pnpm format:fix\`: apply formatting
+- \`pnpm db:migrate\`: run migrations; \`pnpm db:make <name>\`: scaffold a new one
 <% if (nest === 'on') { -%>
-- **api**: NestJS backend (port 3001)
-<% } else if (nest === 'di-only') { -%>
-- **api**: NestJS providers, resolved from the web process (no HTTP server)
+- \`pnpm --filter @<%= projectName %>/api test:e2e\`: run the e2e suite
 <% } -%>
 
-## Packages
+## Environment
 
-- **\`@<%= projectName %>/auth\`**: better-auth config
-- **\`@<%= projectName %>/db\`**: Kysely client and migrations
-- **\`@<%= projectName %>/ui\`**: shared React components
-<% if (linter === 'eslint') { -%>
-- **\`@<%= projectName %>/eslint-config\`**: shared ESLint config
+Set in \`.env\` (a committed \`.env.example\` documents each one):
+
+- **BETTER_AUTH_URL**: the public origin of the app
+- **BETTER_AUTH_SECRET**: a random secret used to sign sessions
+<% if (database === 'postgres') { -%>
+- **DATABASE_URL**: your Postgres connection string
+<% } else { -%>
+- **DATABASE_URL**: not set for SQLite (the app uses \`dev.db\` at the repo root); set it to a Postgres URL to use Postgres
 <% } -%>
-- **\`@<%= projectName %>/typescript-config\`**: shared tsconfig
 
-## Formatting
+## Layout
 
-\`pnpm format\` checks without modifying files and fails if any file is unformatted; \`pnpm format:fix\` applies formatting.
+- **\`apps/web\`**: Next.js frontend (port 3000)
+<% if (nest === 'on') { -%>
+- **\`apps/api\`**: NestJS backend (port 3001)
+<% } else if (nest === 'di-only') { -%>
+- **\`apps/api\`**: NestJS providers, resolved in-process by the web app
+<% } -%>
+- **\`packages/\`**: \`auth\`, \`db\`, \`ui\`<% if (linter === 'eslint') { %>, \`eslint-config\`<% } %>, and shared \`typescript-config\`
 `
 	},
 	{
@@ -252,7 +279,24 @@ Read \`docs/README.md\` inside that installed package first, then read the relev
 This block is written and re-added by \`turbo\` before repository-scoped commands when an AI agent is detected. In the Turborepo source repository, its template is defined in \`crates/turborepo-cli/src/cli/agent_guidance.rs\`. Removing the managed block while updates are enabled means a later qualifying invocation will add it again. Set \`"agentGuidance": false\` in the root \`turbo.json\` or \`turbo.jsonc\` to opt out; this does not remove an existing block. Keep the block committed with your work to avoid an uncommitted change on the next agent invocation.
 <!-- END:turborepo-agent-rules --><% if (shadcn) { %>
 
-After making changes, run \`pnpm lint:check\` and fix all errors.<% } %>`
+After making changes, run \`pnpm lint:check\` and fix all errors.<% } %>
+
+# Project notes
+
+- **web** runs on port 3000<% if (nest === 'on') { %>; **api** (NestJS) runs on port 3001<% } %>.
+<% if (nest === 'on') { -%>
+- In development, \`apps/web\` rewrites \`/api/*\` to \`http://localhost:3001/api/*\` (see \`apps/web/next.config.js\`). The backend is a separate process; start both from the repo root with \`pnpm dev\`.
+<% } else if (nest === 'di-only') { -%>
+- There is no separate backend process. API routes are Next.js route handlers that resolve NestJS providers in-process.
+<% } else { -%>
+- There is no backend. API routes are served in-process by Next.js route handlers.
+<% } -%>
+- Migrations live in \`packages/db\`. Run \`pnpm db:migrate\`; scaffold a new one with \`pnpm db:make <name>\`.
+- Environment is read from the root \`.env\` (see \`.env.example\`): \`DATABASE_URL\`, \`BETTER_AUTH_URL\`, \`BETTER_AUTH_SECRET\`.
+<% if (nest !== 'off') { -%>
+- NestJS controllers must validate request bodies with a schema (the api registers a global \`StandardSchemaValidationPipe\`); keep the todo controller as the reference for how to do it.
+<% } -%>
+`
 	},
 	{
 		filename: "CLAUDE.md",
@@ -337,45 +381,6 @@ yarn-error.log*
 # typescript
 *.tsbuildinfo
 next-env.d.ts`
-		},
-		{
-			filename: "apps/web/README.md",
-			template: `This is a [Next.js](https://nextjs.org) project bootstrapped with [\`create-next-app\`](https://nextjs.org/docs/app/api-reference/create-next-app).
-
-## Getting Started
-
-First, run the development server:
-
-\`\`\`bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
-\`\`\`
-
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
-
-You can start editing the page by modifying \`app/page.tsx\`. The page auto-updates as you edit the file.
-
-This project uses [\`next/font\`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load Inter, a custom Google Font.
-
-## Learn More
-
-To learn more about Next.js, take a look at the following resources:
-
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
-
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
-
-## Deploy on Vercel
-
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
-
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.`
 		},
 		{
 			when: (s) => s.deployment === "none" && s.nest === "on",
@@ -938,21 +943,6 @@ describe('AppService', () => {
     expect(service).toBeDefined();
   });
 });`
-	},
-	{
-		filename: "apps/api/README.md",
-		template: `# API
-
-NestJS backend for the monorepo.
-
-## Scripts
-
-\`\`\`sh
-pnpm dev          # watch mode
-pnpm build        # production build
-pnpm test         # unit tests<% if (nest === 'on') { %>
-pnpm test:e2e     # e2e tests<% } %>
-\`\`\``
 	}
 ] };
 //#endregion
@@ -1106,12 +1096,21 @@ import { FileMigrationProvider, Migrator } from "kysely";
 import { db } from "./index.js";
 
 async function main() {
+  const migrationFolder = path.join(process.cwd(), "src/migrations");
+  try {
+    await fs.access(migrationFolder);
+  } catch {
+    console.log("no migrations yet");
+    await db.destroy();
+    return;
+  }
+
   const migrator = new Migrator({
     db,
     provider: new FileMigrationProvider({
       fs,
       path,
-      migrationFolder: path.join(process.cwd(), "src/migrations"),
+      migrationFolder,
     }),
   });
 
@@ -1178,23 +1177,6 @@ async function main() {
 main();`
 };
 //#endregion
-//#region src/templates/db/templates/migrations-readme.ts
-var migrations_readme_default = {
-	filename: "packages/db/src/migrations/README.md",
-	template: `# Migrations
-
-Kysely migrations run in filename order. Each file exports \`up\` and \`down\`.
-
-\`\`\`bash
-pnpm db:make add_widgets   # scaffold a new migration
-pnpm db:migrate            # apply pending migrations
-\`\`\`
-
-Migrations are written with Kysely's schema builder, so one file compiles to
-both SQLite (dev) and Postgres (prod). Prefer dialect-agnostic column types
-(\`text\`, \`integer\`) and app-generated string ids over auto-increment.`
-};
-//#endregion
 //#region src/templates/db/templates/package-json-sqlite.ts
 var package_json_sqlite_default = {
 	filename: "packages/db/package.json",
@@ -1310,8 +1292,7 @@ const shared = [
 	tsconfig_default$2,
 	src_schema_default,
 	src_migrate_default,
-	scripts_new_migration_default,
-	migrations_readme_default
+	scripts_new_migration_default
 ];
 const dbSqlite = { templates: [
 	...shared,
@@ -1558,7 +1539,7 @@ const versions = {
 	"@nestjs/schematics": "^12.0.5",
 	"@nestjs/serve-static": "^12.0.0",
 	"@nestjs/testing": "^12.1.0",
-	"@next/eslint-plugin-next": "^16.3.4",
+	"@next/eslint-plugin-next": "^16.4.0",
 	"@oxlint/plugins": "^1.74.0",
 	"@shadcn/lint": "^0.1.0",
 	"@shadcn/react": "^0.2.1",
@@ -1602,7 +1583,7 @@ const versions = {
 	jest: "^30.0.0",
 	kysely: "^0.28.2",
 	"lucide-react": "^1.16.0",
-	next: "16.3.4",
+	next: "16.4.0",
 	"next-themes": "^0.4.6",
 	oxfmt: "^0.59.0",
 	oxlint: "^1.80.0",
@@ -11275,37 +11256,10 @@ var plugin_package_json_default = {
 }`
 };
 //#endregion
-//#region src/templates/anti-slop/templates/plugin-readme.ts
-var plugin_readme_default = {
-	filename: "tools/oxlint/anti-slop/README.md",
-	template: `# anti-slop
-
-Oxlint rules that reject low-evidence TypeScript patterns, vendored from
-[dmmulroy/anti-slop](https://github.com/dmmulroy/anti-slop) at \`6d538555cb15\` (MIT, see LICENSE).
-
-Upstream ships these to be vendored rather than depended on, so these files are
-yours: read them, change the messages, delete the rules you disagree with.
-
-\`.oxlintrc.json\` registers the plugin and turns every rule on as an error.
-Turn one off there:
-
-\`\`\`json
-{
-  "rules": {
-    "anti-slop/no-runtime-typeof": "off"
-  }
-}
-\`\`\`
-
-Vendored shadcn components under \`packages/ui/src/components\` are exempt, since
-they are upstream code you re-pull rather than write.
-`
-};
-//#endregion
 //#region src/templates/anti-slop/index.ts
 const plugin = "tools/oxlint/anti-slop";
 const antiSlop = {
-	templates: [plugin_package_json_default, plugin_readme_default],
+	templates: [plugin_package_json_default],
 	staticFiles: [
 		{
 			src: "anti-slop/static/LICENSE",