create-astro 5.0.5 → 5.1.0-beta.0

package/create-astro.mjs

@@ -12,4 +12,4 @@ if (requiredMajorVersion < minimumMajorVersion) {
 	process.exit(1);
 }
 
-import('./dist/index.js').then(({ main }) => main());
+void import('./dist/index.js').then(({ main }) => main());

package/dist/actions/template.d.ts

@@ -14,5 +14,6 @@ export declare function removeTemplateMarkerSections(content: string): string;
  */
 export declare function processTemplateReadme(content: string, packageManager: string): string;
 export declare function template(ctx: Pick<Context, 'template' | 'prompt' | 'yes' | 'dryRun' | 'exit' | 'tasks'>): Promise<void>;
+export declare function generateAgentsMd(): string;
 export declare function getTemplateTarget(tmpl: string, ref?: string): string;
 export declare function isThirdPartyTemplate(tmpl: string): boolean;

package/dist/index.d.ts

@@ -6,7 +6,7 @@ import { next } from './actions/next-steps.js';
 import { projectName } from './actions/project-name.js';
 import { template } from './actions/template.js';
 import { verify } from './actions/verify.js';
-export { processTemplateReadme, removeTemplateMarkerSections } from './actions/template.js';
+export { generateAgentsMd, processTemplateReadme, removeTemplateMarkerSections, } from './actions/template.js';
 export { setStdout } from './messages.js';
 export declare function main(): Promise<void>;
 export { dependencies, getContext, git, intro, next, projectName, template, verify };

package/dist/index.js

@@ -470,7 +470,7 @@ function printHelp({
   if (headline) {
     message.push(
       linebreak(),
-      `${title(commandName)} ${color.green(`v${"5.0.5"}`)} ${headline}`
+      `${title(commandName)} ${color.green(`v${"5.1.0-beta.0"}`)} ${headline}`
     );
   }
   if (usage) {
@@ -569,7 +569,7 @@ async function getContext(argv) {
       packageManager,
       "astro",
       getPackageTag(packageSpecifier),
-      "6.1.2"
+      "7.0.0-beta.6"
     ),
     skipHouston,
     fancy,
@@ -682,17 +682,37 @@ var FILES_TO_REMOVE = ["CHANGELOG.md", ".codesandbox"];
 var FILES_TO_UPDATE = {
   "package.json": (file, overrides) => fs.promises.readFile(file, "utf-8").then((value) => {
     const indent = /(^\s+)/m.exec(value)?.[1] ?? "	";
-    return fs.promises.writeFile(
-      file,
-      JSON.stringify(
-        Object.assign(JSON.parse(value), Object.assign(overrides, { private: void 0 })),
-        null,
-        indent
-      ),
-      "utf-8"
-    );
+    const packageJson = JSON.parse(value);
+    packageJson.name = overrides.name;
+    delete packageJson.private;
+    return fs.promises.writeFile(file, JSON.stringify(packageJson, null, indent), "utf-8");
   })
 };
+function generateAgentsMd() {
+  return `## Development
+
+When starting the dev server, use background mode:
+
+\`\`\`
+astro dev --background
+\`\`\`
+
+Manage the background server with \`astro dev stop\`, \`astro dev status\`, and \`astro dev logs\`.
+
+## Documentation
+
+Full documentation: https://docs.astro.build
+
+Consult these guides before working on related tasks:
+
+- [Adding pages, dynamic routes, or middleware](https://docs.astro.build/en/guides/routing/)
+- [Working with Astro components](https://docs.astro.build/en/basics/astro-components/)
+- [Using React, Vue, Svelte, or other framework components](https://docs.astro.build/en/guides/framework-components/)
+- [Adding or managing content](https://docs.astro.build/en/guides/content-collections/)
+- [Adding styles or using Tailwind](https://docs.astro.build/en/guides/styling/)
+- [Supporting multiple languages](https://docs.astro.build/en/guides/internationalization/)
+`;
+}
 function getTemplateTarget(tmpl, ref = "latest") {
   if (tmpl === "starlight" || tmpl.startsWith("starlight/")) {
     const [, starter = "basics"] = tmpl.split("/");
@@ -748,6 +768,17 @@ async function copyTemplate(tmpl, ctx) {
       }
       throw new Error(`Unable to download template ${color2.reset(tmpl)}`);
     }
+    const agentsPath = path.resolve(ctx.cwd, "AGENTS.md");
+    const claudePath = path.resolve(ctx.cwd, "CLAUDE.md");
+    fs.writeFileSync(agentsPath, generateAgentsMd());
+    try {
+      fs.symlinkSync("AGENTS.md", claudePath);
+    } catch {
+      try {
+        fs.linkSync(agentsPath, claudePath);
+      } catch {
+      }
+    }
     const removeFiles = FILES_TO_REMOVE.map(async (file) => {
       const fileLoc = path.resolve(path.join(ctx.cwd, file));
       if (fs.existsSync(fileLoc)) {
@@ -1154,6 +1185,7 @@ async function main() {
 }
 export {
   dependencies,
+  generateAgentsMd,
   getContext,
   git,
   intro,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-astro",
-  "version": "5.0.5",
+  "version": "5.1.0-beta.0",
   "type": "module",
   "author": "withastro",
   "license": "MIT",
@@ -30,8 +30,8 @@
   },
   "devDependencies": {
     "arg": "^5.0.2",
-    "astro-scripts": "0.0.14",
-    "@astrojs/internal-helpers": "0.8.0"
+    "@astrojs/internal-helpers": "0.10.0",
+    "astro-scripts": "0.0.14"
   },
   "engines": {
     "node": ">=22.12.0"
@@ -40,9 +40,9 @@
     "provenance": true
   },
   "scripts": {
-    "build": "astro-scripts build \"src/index.ts\" --bundle && tsc",
+    "build": "astro-scripts build \"src/index.ts\" --bundle && tsc -b",
     "build:ci": "astro-scripts build \"src/index.ts\" --bundle",
     "dev": "astro-scripts dev \"src/**/*.ts\"",
-    "test": "astro-scripts test \"test/**/*.test.js\""
+    "test": "astro-scripts test \"test/**/*.test.ts\""
   }
 }