create-minista 4.0.10 → 5.0.0-alpha.0

package/README.md

@@ -2,22 +2,24 @@
 
 ## About
 
-簡単なコマンド入力で[minista](https://minista.qranoko.jp/)のプロジェクトを開始できます。
+Start a [minista](https://minista.qranoko.jp/) project with a simple command.
 
 ## How To Use
 
 ```sh
 # Interactive
-$ npm create minista@latest
+npm create minista@latest
 
 # Shortcut
-$ npm create minista@latest my-minista-project -- --template minimal-ts
+npm create minista@latest my-minista-project -- --template minimal-ts
 ```
 
-|テンプレート|内容                            |
-| ------------ | ------------------------------- |
-| `minimal-js` | JavaScriptを使った最低限の構成|
-| `minimal-ts` | TypeScriptを使った最低限の構成|
+| Template     | Description                   |
+| ------------ | ----------------------------- |
+| `basic-js`   | Basic setup with JavaScript   |
+| `basic-ts`   | Basic setup with TypeScript   |
+| `minimal-js` | Minimal setup with JavaScript |
+| `minimal-ts` | Minimal setup with TypeScript |
 
 ## License
 
@@ -27,3 +29,15 @@ $ npm create minista@latest my-minista-project -- --template minimal-ts
 
 - Author: [Qrac](https://qrac.jp)
 - Organization: [QRANOKO](https://qranoko.jp)
+
+## Agent Guide
+
+Every template creates a short `AGENTS.md` that points to `npx --no-install minista agents`.
+
+Existing instructions are preserved. After installation, run the following command to add or update only the minista block:
+
+```sh
+npx --no-install minista agents --write
+```
+
+The detailed guide is included with the installed version of minista.

package/agents/bootstrap.md

@@ -0,0 +1,10 @@
+<!-- minista:agents:start -->
+## minista
+
+Before changing minista configuration, routes, pages, layouts, plugins, or build behavior,
+run `npx --no-install minista agents` to read the guide shipped with the installed version.
+Run `npx --no-install minista agents --json` to locate generated workspace metadata.
+Use `npx --no-install minista inspect --manifest --json` to inspect the last build;
+use `check --json` or `inspect --json` when current source analysis is needed.
+Generated metadata may be stale. Do not edit generated workspace files manually.
+<!-- minista:agents:end -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-minista",
-  "version": "4.0.10",
+  "version": "5.0.0-alpha.0",
   "type": "module",
   "bin": {
     "create-minista": "./bin/create-minista.js"
@@ -8,7 +8,8 @@
   "files": [
     "bin",
     "src",
-    "templates"
+    "templates",
+    "agents"
   ],
   "license": "MIT",
   "homepage": "https://minista.qranoko.jp",
@@ -28,7 +29,7 @@
     "minista"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": "^20.19.0 || >=22.12.0"
   },
   "dependencies": {
     "cac": "^7.0.0",

package/src/agents.js

@@ -0,0 +1,15 @@
+import fs from "node:fs/promises"
+import path from "node:path"
+
+/** Seed every template with the same entry point, retaining existing instructions.
+ * @param {string} root
+ */
+export async function writeAgentBootstrap(root) {
+  const block = await fs.readFile(new URL("../agents/bootstrap.md", import.meta.url), "utf8")
+  try {
+    await fs.writeFile(path.join(root, "AGENTS.md"), block, { encoding: "utf8", flag: "wx" })
+  } catch (error) {
+    if (!error || typeof error !== "object" || Reflect.get(error, "code") !== "EEXIST") throw error
+    console.log("AGENTS.md preserved. Run npx --no-install minista agents --write after installation to add the minista guide.")
+  }
+}

package/src/index.js

@@ -9,13 +9,24 @@ import path from "node:path"
 import pc from "picocolors"
 import { cac } from "cac"
 import prompts from "prompts"
+import { writeAgentBootstrap } from "./agents.js"
 
 /** @type {{ title: string, value: string }[]} */
 const TEMPLATES = [
-  { title: "Minimal (JavaScript)", value: "minimal-js" },
-  { title: "Minimal (Typescript)", value: "minimal-ts" },
+  { title: "Basic", value: "basic" },
+  { title: "Minimal", value: "minimal" },
 ]
 
+/** @type {{ title: string, value: string }[]} */
+const LANGUAGES = [
+  { title: "TypeScript", value: "ts" },
+  { title: "JavaScript", value: "js" },
+]
+
+const TEMPLATE_NAMES = TEMPLATES.flatMap((template) =>
+  LANGUAGES.map((language) => `${template.value}-${language.value}`),
+)
+
 /**
  * @returns {string}
  */
@@ -51,7 +62,7 @@ function resolveTemplateDir(template) {
  * @returns {boolean}
  */
 function hasTemplate(template) {
-  return TEMPLATES.some((item) => item.value === template)
+  return TEMPLATE_NAMES.includes(template)
 }
 
 /**
@@ -90,6 +101,12 @@ async function main(root, options) {
       message: "Which template would you like to use?",
       choices: TEMPLATES,
     },
+    language: {
+      type: "select",
+      name: "language",
+      message: "Which language would you like to use?",
+      choices: LANGUAGES,
+    },
   }
 
   if (fs.existsSync(cwd)) {
@@ -102,19 +119,25 @@ async function main(root, options) {
     if (!current) mkdirp(cwd)
   }
 
-  const configs = template
-    ? { template }
-    : /** @type {{ template: string }} */ (await prompts(questions.template))
+  let selectedTemplate = template
+  if (!selectedTemplate) {
+    const answers = /** @type {{ template?: string, language?: string }} */ (
+      await prompts([questions.template, questions.language], {
+        onCancel: () => process.exit(1),
+      })
+    )
+    selectedTemplate = `${answers.template}-${answers.language}`
+  }
 
-  if (!hasTemplate(configs.template)) {
-    console.error(pc.red(`Unknown template: ${configs.template}`))
+  if (!hasTemplate(selectedTemplate)) {
+    console.error(pc.red(`Unknown template: ${selectedTemplate}`))
     console.error(
-      pc.gray(`Available templates: ${TEMPLATES.map((item) => item.value).join(", ")}`),
+      pc.gray(`Available templates: ${TEMPLATE_NAMES.join(", ")}`),
     )
     process.exit(1)
   }
 
-  const templateDir = resolveTemplateDir(configs.template)
+  const templateDir = resolveTemplateDir(selectedTemplate)
 
   try {
     console.log(`${pc.green(">")} ${pc.gray("Copying project files...")}`)
@@ -124,6 +147,7 @@ async function main(root, options) {
       errorOnExist: false,
     })
     await renameGitignore(cwd)
+    await writeAgentBootstrap(cwd)
   } catch (err) {
     console.error(
       pc.red(err instanceof Error && err.message ? err.message : String(err)),

package/templates/basic-js/_gitignore

@@ -0,0 +1,7 @@
+.DS_Store
+Thumbs.db
+db.json
+*.log
+node_modules
+dist
+.minista

package/templates/basic-js/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "minista-project",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "dev": "minista",
+    "build": "minista build",
+    "preview": "minista preview"
+  },
+  "devDependencies": {
+    "minista": "^5.0.0-alpha.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "vite": "^8.3.0"
+  }
+}

package/templates/basic-js/project.json

@@ -0,0 +1,21 @@
+{
+  "siteName": "minista project",
+  "navItems": [
+    {
+      "label": "Home",
+      "url": "/"
+    },
+    {
+      "label": "About",
+      "url": "/about"
+    },
+    {
+      "label": "Page 1",
+      "url": "/nest/page-1"
+    },
+    {
+      "label": "Page 2",
+      "url": "/nest/page-2"
+    }
+  ]
+}

package/templates/basic-js/src/assets/entries/scripts.js

@@ -0,0 +1,3 @@
+console.log("Hello!")
+
+export {}

package/templates/basic-js/src/assets/images/icon.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 152 152" xmlns="http://www.w3.org/2000/svg"><path d="m65.34 95.32c.37-.63.56-1.7.56-2.76h-40.53c-4.28 0-7.79-3.51-7.79-7.79v-50.63c0-4.28 3.51-7.79 7.79-7.79h62.32c4.28 0 6.01 3.02 3.84 6.71l-10.94 18.6h18.07l6.3-10.7c3.89-6.61 4.11-14.23.6-20.38-3.52-6.15-10.19-9.82-17.86-9.82h-62.33c-12.89 0-23.37 10.48-23.37 23.37v50.63c0 12.89 10.48 23.37 23.37 23.37h32.43z" fill="#00c3df"/><path d="m126.63 59.45c4.28 0 7.79 3.51 7.79 7.79v50.63c0 4.28-3.51 7.79-7.79 7.79h-62.32c-4.28 0-6.01-3.02-3.84-6.71l11.57-19.68c2.17-3.69 2.17-9.74 0-13.43l-11.57-19.68c-2.17-3.69-.44-6.71 3.84-6.71zm0-15.58h-62.32c-7.67 0-14.35 3.67-17.86 9.82-3.52 6.15-3.29 13.76.6 20.38l10.88 18.49-10.88 18.49c-3.89 6.61-4.11 14.23-.6 20.38 3.52 6.15 10.19 9.82 17.86 9.82h62.32c12.89 0 23.37-10.48 23.37-23.37v-50.63c0-12.89-10.48-23.37-23.37-23.37z" fill="#fc6adf"/></svg>

package/templates/basic-js/src/components/footer/index.jsx

@@ -0,0 +1,13 @@
+import styles from "./style.module.css"
+
+/** @param {{ siteName: string }} props */
+export default function Footer({ siteName }) {
+  const year = new Date().getFullYear()
+  return (
+    <footer className={styles.footer}>
+      <p className={styles.copyright}>
+        © {year} {siteName}
+      </p>
+    </footer>
+  )
+}

package/templates/basic-js/src/components/footer/style.module.css

@@ -0,0 +1,9 @@
+.footer {
+  padding: 32px;
+}
+
+.copyright {
+  margin: 0;
+  color: var(--theme-tx-3);
+  font-size: 0.875rem;
+}

package/templates/basic-js/src/components/header/index.jsx

@@ -0,0 +1,15 @@
+import Nav from "../nav"
+
+import styles from "./style.module.css"
+
+/** @param {{ siteName: string, currentUrl: string, navItems: { label: string, url: string }[] }} props */
+export default function Header(props) {
+  return (
+    <header className={styles.header}>
+      <a href="/" className={styles.siteName}>
+        {props.siteName}
+      </a>
+      <Nav currentUrl={props.currentUrl} navItems={props.navItems} />
+    </header>
+  )
+}

package/templates/basic-js/src/components/header/style.module.css

@@ -0,0 +1,15 @@
+.header {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  flex-wrap: wrap;
+  padding: 32px;
+}
+
+.siteName {
+  flex: 1 0;
+  color: var(--theme-tx-1);
+  font-weight: 700;
+  text-decoration: none;
+  white-space: nowrap;
+}

package/templates/basic-js/src/components/nav/index.jsx

@@ -0,0 +1,22 @@
+import styles from "./style.module.css"
+
+/** @param {{ currentUrl: string, navItems: { label: string, url: string }[] }} props */
+export default function Nav(props) {
+  return (
+    <nav>
+      <ul className={styles.list}>
+        {props.navItems.map((item) => (
+          <li key={item.url}>
+            <a
+              className={styles.link}
+              href={item.url}
+              aria-current={props.currentUrl === item.url ? "page" : undefined}
+            >
+              {item.label}
+            </a>
+          </li>
+        ))}
+      </ul>
+    </nav>
+  )
+}

package/templates/basic-js/src/components/nav/style.module.css

@@ -0,0 +1,16 @@
+.list {
+  display: flex;
+  gap: 1rem;
+  padding: 0;
+  list-style: none;
+}
+
+.link {
+  font-size: 0.875rem;
+  color: var(--theme-tx-3);
+  text-decoration: none;
+}
+
+.link[aria-current="page"] {
+  color: var(--theme-tx-1);
+}

package/templates/basic-js/src/layouts/index.jsx

@@ -0,0 +1,31 @@
+import Header from "../components/header"
+import Footer from "../components/footer"
+import "./style.css"
+
+import pjt from "../../project.json"
+
+/** @param {import("minista/types").LayoutProps} props */
+export default function (props) {
+  const { siteName, navItems } = pjt
+  const title = props.title ? `${props.title} - ${siteName}` : siteName
+  return (
+    <html lang="en">
+      <head>
+        <meta charSet="utf-8" />
+        <meta name="viewport" content="width=device-width" />
+        <title>{title}</title>
+        <script src="/src/assets/entries/scripts.js" type="module" />
+        <link rel="icon" href="/favicon.png" />
+      </head>
+      <body>
+        <Header
+          siteName={siteName}
+          currentUrl={props.url}
+          navItems={navItems}
+        />
+        <main>{props.children}</main>
+        <Footer siteName={siteName} />
+      </body>
+    </html>
+  )
+}

package/templates/basic-js/src/layouts/style.css

@@ -0,0 +1,33 @@
+:root {
+  --theme-bg: #18212f;
+  --theme-tx-1: oklch(94% 0.02 277.99);
+  --theme-tx-2: oklab(83.222% -0.00085 -0.00903);
+  --theme-tx-3: oklab(0.56 0 -0.02);
+  --font-sans:
+    system-ui, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans",
+    sans-serif;
+}
+
+body {
+  color-scheme: dark;
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  grid-template-rows: auto 1fr auto;
+  min-height: 100svh;
+  margin: 0;
+  background-color: var(--theme-bg);
+  color: var(--theme-tx-1);
+  font-family: var(--font-sans);
+}
+
+main {
+  padding: 0 32px;
+}
+
+h1 {
+  color: var(--theme-tx-1);
+}
+
+p {
+  color: var(--theme-tx-2);
+}

package/templates/basic-js/src/pages/about.jsx

@@ -0,0 +1,17 @@
+/** @type {import("minista/types").Metadata} */
+export const metadata = {
+  title: "About",
+  draft: false, // true = Don't build the page
+}
+
+/** @param {import("minista/types").PageProps} props */
+export default function (props) {
+  return (
+    <>
+      <h1>{props.title}</h1>
+      <p>
+        This is a sample page. You can edit this page at "src/pages/about.jsx".
+      </p>
+    </>
+  )
+}

package/templates/basic-js/src/pages/index.jsx

@@ -0,0 +1,17 @@
+import icon from "../assets/images/icon.svg"
+
+/** @type {import("minista/types").Metadata} */
+export const metadata = {}
+
+/** @param {import("minista/types").PageProps} props */
+export default function (props) {
+  return (
+    <>
+      <h1>Hello!</h1>
+      <p>
+        This is a sample page. You can edit this page at "src/pages/index.jsx".
+      </p>
+      <img src={icon} alt="Hero" width="60" height="60" />
+    </>
+  )
+}

package/templates/basic-js/src/pages/nest/page-1.md

@@ -0,0 +1,10 @@
+---
+title: Page 1
+draft: false
+---
+
+# Page 1
+
+This is a sample page. You can edit this page at "src/pages/nest/page-1.md".
+
+You can use MDX files instead of Markdown files.

package/templates/basic-js/src/pages/nest/page-2.mdx

@@ -0,0 +1,10 @@
+---
+title: Page 2
+draft: false
+---
+
+# {props.title}
+
+This is a sample page. You can edit this page at "src/pages/nest/page-2.mdx".
+
+You can also use Markdown files instead of MDX files.

package/templates/basic-js/vite.config.js

@@ -0,0 +1,8 @@
+import { defineConfig, pluginSsg } from "minista"
+
+export default defineConfig({
+  plugins: [pluginSsg()],
+  build: {
+    assetsInlineLimit: 0,
+  },
+})

package/templates/basic-ts/.minista/diagnostics.json

@@ -0,0 +1,16 @@
+{
+  "buildId": "acafc040-bf89-4827-94f7-dcdcc63d859e",
+  "command": "build",
+  "createdAt": "2026-09-06T15:58:08.264Z",
+  "diagnostics": [],
+  "generator": {
+    "name": "minista",
+    "version": "5.0.0"
+  },
+  "schemaVersion": "1",
+  "summary": {
+    "errors": 0,
+    "info": 0,
+    "warnings": 0
+  }
+}