create-clientkit 0.1.0 → 1.0.1

package/README.md

@@ -15,10 +15,8 @@ it lands on disk.
 npm create clientkit@latest acme-website
 ```
 
----
-
-> **Status: pre-release (0.1.0).** Feature-complete for V1 and verified in CI
-> across Windows, macOS and Linux, but not yet published to npm.
+[![npm](https://img.shields.io/npm/v/create-clientkit)](https://www.npmjs.com/package/create-clientkit)
+[![CI](https://github.com/JosuK22/create-clientkit/actions/workflows/ci.yml/badge.svg)](https://github.com/JosuK22/create-clientkit/actions/workflows/ci.yml)
 
 ---
 
@@ -41,11 +39,12 @@ and warns before generating that the project itself will need 22.12+.
 | Windows | yes | yes            | Node 20.19, 22, 24 (site: 22)     |
 | macOS   | yes | yes            | Node 20.19, 22, 24 (site: 22)     |
 
-> **Verification status.** Windows is verified directly — the full test suite,
-> clean-room packaging and generated-project builds are run there. The Linux
-> and macOS rows describe what `.github/workflows/ci.yml` covers; that
-> workflow has not yet executed on GitHub-hosted runners, so treat those rows
-> as intended coverage rather than observed results until the first CI run.
+> **Verification status.** Every row above is observed, not intended: the CI
+> workflow runs on GitHub-hosted runners for all three platforms on each push.
+> One exception is called out honestly — Ctrl+C cancellation cannot be tested
+> on Windows, which has neither pty allocation nor POSIX signal delivery to a
+> child process, so `scripts/cancel-check.mjs` prints the manual procedure
+> there instead of asserting anything.
 
 ## Usage
 
@@ -166,12 +165,18 @@ on after launch keeps the real site invisible.
 
 1. Set `SITE.url` in `src/config/site.config.ts` — canonical URLs and the
    sitemap depend on it.
-2. Replace `public/favicon.svg` with the client's mark.
-3. Add a 1200×630 image to `public/` and set `SEO.image` if you want social
-   previews. No `og:image` is emitted until you do.
-4. Fill in `CONTACT` and `SOCIAL` — anything left empty is not rendered, and
+2. Rewrite `SITE.description`. It is generated as `Official website of <Name>.`
+   — deliberately generic, because the CLI will not invent claims about a
+   business it knows nothing about. It is a placeholder, and it becomes the
+   meta description, `og:description` and the X card description. Aim for
+   roughly 120–160 characters of real copy.
+3. Replace `public/favicon.svg` with the client's mark.
+4. Add a 1200×630 image to `public/` and set `SEO.image` if you want social
+   previews. No `og:image` is emitted until you do, and the X card stays
+   `summary` rather than rendering an empty `summary_large_image`.
+5. Fill in `CONTACT` and `SOCIAL` — anything left empty is not rendered, and
    not claimed in the structured data.
-5. `npm run check && npm run build`, then deploy `dist/` as a static site.
+6. `npm run check && npm run build`, then deploy `dist/` as a static site.
 
 Only the origin of `SITE.url` is used. To deploy under a subpath, also set
 `base` in `astro.config.mjs`.
@@ -222,6 +227,13 @@ The CLI publishes with `dependencies: {}` — its dependencies are bundled into
 resolution. See [THIRD-PARTY.md](./THIRD-PARTY.md) and
 [RELEASING.md](./RELEASING.md).
 
+## Contributing
+
+Bug reports and ideas are welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md).
+The quickest useful report is an
+[issue from a template](https://github.com/JosuK22/create-clientkit/issues/new/choose),
+since they ask for the versions and the exact command up front.
+
 ## Licence
 
 MIT — see [LICENSE](./LICENSE). Generated client projects are **not** MIT; they

package/dist/cli.js

@@ -2418,9 +2418,12 @@ function helpText() {
     npm create clientkit@latest acme-website --yes --no-install
     npm create clientkit@latest --from ./agency-preset.json --dry-run
 
-  Note
-    Early build: configuration is resolved and validated, but no files are
-    generated yet.
+  Notes
+    Dependencies are installed and a git repository is initialised by default.
+    Pass --no-install or --no-git to skip either.
+
+    The generated project is yours - private, unlicensed and dependency-pinned.
+    Nothing phones home and nothing is downloaded beyond your own install.
 `.trimStart();
 }
 
@@ -2474,7 +2477,7 @@ var Logger = class {
 };
 
 // src/version.ts
-var CLI_VERSION = true ? "0.1.0" : "0.0.0-dev";
+var CLI_VERSION = true ? "1.0.1" : "0.0.0-dev";
 
 // src/cli.ts
 async function main(argv, options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-clientkit",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "description": "Create the boring foundation of your next client website in seconds.",
   "keywords": [
     "cli",
@@ -51,10 +51,11 @@
     "audit": "node scripts/audit-site.mjs",
     "preflight": "node scripts/preflight.mjs",
     "verify": "npm run typecheck && npm run lint && npm run format:check && npm run test && npm run build",
-    "prepublishOnly": "npm run preflight",
+    "prepublishOnly": "node scripts/preflight.mjs --skip-if-verified",
     "cancel-check": "node scripts/cancel-check.mjs",
     "drift": "node scripts/drift-probe.mjs",
-    "drift:report": "node scripts/drift-probe.mjs --report"
+    "drift:report": "node scripts/drift-probe.mjs --report",
+    "drift:selftest": "node scripts/drift-probe.mjs --simulate-drift tailwindcss@4.3.2"
   },
   "devDependencies": {
     "@clack/prompts": "^0.11.0",

package/templates/astro-tailwind/base/README.md

@@ -64,6 +64,12 @@ what it needs to override:
 **Everything derives from `SITE`.** You never repeat the site name,
 description or URL.
 
+### Set the URL before the final build
+
+`SITE.url` is read at **build time**, so canonical tags, `og:url` and the
+sitemap are baked into the output. Moving a built site to a different domain
+leaves them pointing at the old one - rebuild after changing it.
+
 ### Before you have a domain
 
 `SITE.url` starts empty and that is a supported state, not a broken one. While
@@ -72,6 +78,20 @@ sitemap and the sitemap line in `robots.txt` - rather than pointing them at a
 domain nobody owns yet. Fill `SITE.url` in and they all appear. Only the
 origin is used; a subpath deployment also needs Astro's `base` option.
 
+### Social previews and the description
+
+`SITE.description` arrives as `Official website of {{siteName}}.` That is a
+placeholder, not a suggestion. It was generated without knowing anything about
+the business, and it becomes the meta description, `og:description` and the X
+card description - so it is worth replacing with real copy, roughly 120-160
+characters, before launch.
+
+`SEO.image` starts empty and no `og:image` is emitted while it is. The X card
+stays `summary` in that state rather than claiming `summary_large_image` with
+no image to show, which renders as an empty card. Drop a 1200x630 image into
+`public/`, point `SEO.image` at it, and the card switches to the large format
+on its own.
+
 ### Indexing
 
 `SEO.noindex` controls it, and it is `false` by default so a launched site is

package/templates/astro-tailwind/base/src/components/Footer.astro

@@ -4,7 +4,12 @@ import { CONTACT, SITE, SOCIAL } from '../config/site.config.ts';
 
 // Computed at build time rather than frozen in at scaffold time, so the notice
 // stays correct for as long as the site is rebuilt.
-const year = new Date().getFullYear();
+//
+// Built as one string rather than as adjacent `{year} {SITE.name}` expressions
+// in the markup: a formatter may put those on separate lines, and Astro drops
+// the newline between two adjacent expressions, which silently renders
+// "2026Acme Studio" with no space.
+const copyright = `© ${new Date().getFullYear()} ${SITE.name}`;
 
 const hasSocial = SOCIAL.some((link) => link.label !== '' && link.href !== '');
 const hasContact = CONTACT.email !== '' || CONTACT.phone !== '';
@@ -12,10 +17,7 @@ const hasContact = CONTACT.email !== '' || CONTACT.phone !== '';
 
 <footer class="site-footer">
   <div class="container-page inner">
-    <p class="copyright">
-      &copy; {year}
-      {SITE.name}
-    </p>
+    <p class="copyright">{copyright}</p>
 
     {
       (hasContact || hasSocial) && (