create-shibumi 0.2.7 → 0.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-shibumi",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Scaffold a Shibumi Stack project: Bun, Hono, Zod, Drizzle, SQLite, Alpine",
   "type": "module",
   "bin": {

package/scripts/shibumi.lock.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.0",
+  "version": "0.2.7",
   "extensions": [
     {
       "name": "admin",
@@ -18,5 +18,5 @@
       "version": "1.0.1"
     }
   ],
-  "sha256": "10386d9e6db61626780e85ef6bcc423e88402606b8ce9baa2c222e61cd32f134"
+  "sha256": "f859ca8e76ee58d8bbafb162ec8e06a794c9db6586759916a8e4b4d45568c5d4"
 }

package/scripts/ship.lock.json

@@ -1,4 +1,4 @@
 {
-  "url": "https://shibumistack.dev/ship/v46.ts",
-  "sha256": "bf1a6efb177a8a5e20e36b7e2c0bcec6bc5a8598dfd4f86e7ff129af92a0e648"
+  "url": "https://shibumistack.dev/ship/v47.ts",
+  "sha256": "7c4bee760498bea9f857934088e9fc1e3c1b835dfd49deb382d103248adedc63"
 }

package/src/templates/blog/agents.md

@@ -14,7 +14,9 @@ bun ship         # verify dist/, build the static image, upload, deploy
 
 ## Routes and templates
 
-- Posts are markdown files in `src/content/blog/`; the schema in `src/content.config.ts` requires title (max 60), description (50 to 160 characters, drives meta/RSS/llms.txt), date, optional ogImage.
+- Posts are markdown files in `src/content/blog/`; the schema in `src/content.config.ts` requires title (max 60), description (50 to 160 characters, drives meta/RSS/llms.txt), date, optional ogImage, and an optional `draft` flag (default false).
+- `draft: true` keeps a post out of everything: no page, no listing, no RSS, no llms.txt, no markdown alternate. Publish by removing the flag and running `bun ship`.
+- Images: put files in `src/assets/` and reference them relatively from the markdown (`![alt](../../assets/photo.jpg)`); Astro optimizes them at build. Files in `public/` are served verbatim by URL.
 - `src/pages/index.astro` lists posts; `src/pages/posts/[id].astro` renders one; `src/layouts/Base.astro` and `src/components/BaseHead.astro` own the frame and every meta tag.
 - Generated endpoints: `/rss.xml`, `/llms.txt`, `/robots.txt`, and a markdown alternate for every post at `/posts/<id>.md`. All derive from the content collection; never hand-edit their output.
 - Site identity lives in `src/site.ts`. Design lives in `public/style.css` (one file, shibumi tokens, semantic selectors).

package/src/templates/blog/bun.lock

@@ -11,6 +11,7 @@
       },
       "devDependencies": {
         "@astrojs/check": "0.9.10",
+        "@clack/prompts": "1.7.0",
         "typescript": "5.9.2",
       },
     },

package/src/templates/blog/package.json

@@ -9,7 +9,7 @@
     "check": "astro check",
     "preview": "astro preview",
     "ship": "bun scripts/ship.ts",
-    "ship:setup": "bun scripts/ship.ts --setup --static --output-dir dist --build-script build",
+    "ship:setup": "bun scripts/ship.ts --setup --static --output-dir dist --build-script build --no-spa",
     "ship:update": "bun scripts/ship.ts --update",
     "ship:status": "bun scripts/ship.ts --status",
     "ship:logs": "bun scripts/ship.ts --logs"
@@ -21,6 +21,7 @@
   },
   "devDependencies": {
     "@astrojs/check": "0.9.10",
+    "@clack/prompts": "1.7.0",
     "typescript": "5.9.2"
   },
   "engines": {

package/src/templates/blog/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><style>text{fill:#e95f19;font-family:"Hiragino Sans","Noto Sans JP",sans-serif}@media (prefers-color-scheme:dark){text{fill:#ff8648}}</style><text x="50" y="55" font-size="62" text-anchor="middle" dominant-baseline="central">渋</text></svg>

package/src/templates/blog/public/style.css

@@ -36,14 +36,27 @@
     line-height: 1.6;
 
     > header {
-      border-bottom: 1px solid var(--hairline);
-      padding-bottom: 1rem;
+      max-width: 40.5rem;
+      margin: 0 auto;
+      padding-top: 1rem;
 
       a {
+        display: inline-flex;
+        align-items: center;
+        gap: 0.7rem;
         color: var(--ink);
-        font-weight: 600;
+        font-family: ui-serif, Georgia, "Iowan Old Style", Cambria, serif;
+        font-size: 1.25rem;
+        font-weight: 500;
+        letter-spacing: 0.01em;
         text-decoration: none;
       }
+
+      .mark-badge {
+        color: var(--accent);
+        font-family: "Hiragino Sans", "Noto Sans JP", sans-serif;
+        font-size: 1.125rem;
+      }
     }
 
     > main {
@@ -53,7 +66,6 @@
     }
 
     > footer {
-      border-top: 1px solid var(--hairline);
       padding-block: 4rem;
       text-align: center;
       color: var(--muted);
@@ -145,3 +157,64 @@
     margin-top: 0;
   }
 }
+
+/* Post images: full column width, soft corners, credit line stays quiet. */
+article img {
+  display: block;
+  width: 100%;
+  height: auto;
+  border-radius: 0.6rem;
+  opacity: 0.9;
+  transition: opacity 200ms ease;
+}
+
+article img:hover,
+article img:focus-visible {
+  opacity: 1;
+}
+
+article small {
+  display: block;
+  margin-top: 0.5rem;
+  color: var(--muted);
+  font-size: 0.8rem;
+}
+
+.home-title {
+  display: flex;
+  align-items: baseline;
+  gap: 1rem;
+}
+
+.home-title .mark-badge {
+  color: var(--accent);
+  font-family: "Hiragino Sans", "Noto Sans JP", sans-serif;
+  font-size: 0.42em;
+}
+
+.post-end {
+  margin-top: 4rem;
+}
+
+.ghost-pill {
+  display: inline-block;
+  padding: 0.5rem 1.3rem;
+  border: 1px solid var(--hairline);
+  border-radius: 999px;
+  color: var(--muted);
+  text-decoration: none;
+  transition: color 160ms ease, border-color 160ms ease;
+}
+
+.ghost-pill:hover,
+.ghost-pill:focus-visible {
+  color: var(--accent);
+  border-color: var(--accent);
+}
+
+article :not(pre) > code {
+  padding: 0.12em 0.42em;
+  border-radius: 0.35rem;
+  background: color-mix(in srgb, var(--ink) 6%, transparent);
+  font-size: 0.85em;
+}

package/src/templates/blog/src/components/BaseHead.astro

@@ -1,4 +1,5 @@
 ---
+import { ClientRouter } from "astro:transitions";
 import { SITE } from "../site";
 
 interface Props {
@@ -16,6 +17,9 @@ const isArticle = Boolean(publishedTime);
 ---
 
 <meta charset="utf-8" />
+<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+<meta name="generator" content="create-shibumi (shibumistack.dev)" />
+<ClientRouter />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>{title}</title>
 <meta name="description" content={description} />

package/src/templates/blog/src/content/blog/one-vps-is-plenty.md

@@ -1,13 +1,15 @@
 ---
 title: One VPS is plenty
-description: A five-euro server runs more blogs than most of us will ever write. The hard part was never capacity; it was confidence.
+description: This blog is static files in a 1.4 MB container on a shared five-euro VPS. The deploy script, not the hardware, is what platforms were selling.
 date: 2026-07-15
 ---
 
-This site is static files behind a 1.4 MB container on a small VPS. It could serve every reader I will ever have from a machine that also runs four other projects.
+This site is static files behind a 1.4 MB container on a small VPS that also runs four other projects. A five-euro machine serves this traffic without noticing.
 
-What kept people off their own servers was never capacity. It was the deploy story: what happens when the build breaks, how you roll back, whether the thing you tested is the thing that shipped. Platforms answered those questions and charged rent on the answer.
+People stayed on platforms for the deploy story: what happens when the build breaks, how to roll back, whether the thing you tested is the thing that shipped.
 
-The answers turn out to be portable. Build the exact commit, verify the output, ship the image, health-check before cutover, keep the previous image for rollback. None of that requires a platform; it requires a script you can read.
+![A single stack of balanced stones by the sea](https://images.pexels.com/photos/289586/pexels-photo-289586.jpeg?auto=compress&cs=tinysrgb&w=1200)
 
-Rent is fine. Owning is calmer.
+<small>Photo via [Pexels](https://www.pexels.com/photo/289586/)</small>
+
+Those answers fit in a script. Build the exact commit, verify the output, upload the image over SSH, health-check before cutover, keep the previous image for rollback. `bun ship` runs all of it, and the script is short enough to read before you trust it.

package/src/templates/blog/src/content/blog/own-your-source.md

@@ -1,13 +1,17 @@
 ---
 title: Own your source
-description: Frameworks lend you abstractions and charge interest. Generated code you can read is a debt-free way to start a project.
+description: This starter copies routes, styles, and config into your repository as plain files. What that costs you, and what it saves, six months in.
 date: 2026-08-01
 ---
 
-Most starters hand you a dependency. This one hands you files.
+This starter does not install itself as a dependency. It copies files into your repository and gets out of the way.
 
-The difference shows up six months in. When behavior lives in a package, changing it means reading someone else's issue tracker. When behavior lives in your repository, changing it means editing a file you have already read.
+The difference shows up six months in. To change behavior that lives in a package, you read someone else's issue tracker and wait for a release. To change behavior that lives in your repository, you edit a file you have already read.
 
-Generated code has a bad reputation because generators used to produce piles you could not maintain. The fix is not less generation; it is generating less. A route file, a layout, a stylesheet with five variables. Small enough to read in one sitting, which means small enough to own.
+![Six calligraphy brushes laid out on paper](https://images.pexels.com/photos/6315632/pexels-photo-6315632.jpeg?auto=compress&cs=tinysrgb&w=1200)
 
-There is a test for this: delete the tool that made the project. If the project still builds, still deploys, and still makes sense, you own it. If not, you rented it.
+<small>Photo via [Pexels](https://www.pexels.com/photo/close-up-of-ink-brushes-6315632/)</small>
+
+Generated code earned its bad reputation from generators that produced more code than anyone could maintain. So this one generates little: a route file, a layout, a stylesheet with five variables. Reading all of it takes one sitting.
+
+One test tells you whether you own a project: delete the tool that made it. This site still builds, still deploys, and still makes sense with create-shibumi gone.

package/src/templates/blog/src/content/blog/writing-for-agents.md

@@ -1,13 +1,15 @@
 ---
 title: Writing for readers who curl
-description: Half your readers are now programs. Serving markdown alternates and an llms.txt costs one endpoint and respects both audiences.
+description: Every post here is served twice, as rendered HTML and as plain markdown, with an llms.txt index. One endpoint covers the agent readers.
 date: 2026-06-20
 ---
 
-Someone will read this post in a browser. Something will read it with an HTTP client and a token budget.
+Half the readers of this post are agents: HTTP clients with a token budget instead of a viewport.
 
-The polite response is to serve both well. Every post here exists twice: the HTML you may be reading, and a plain markdown file at the same path with `.md` on the end. An `llms.txt` at the root lists them all with one-line summaries, so an agent can survey the whole site in a single small request instead of scraping navigation markup.
+So every post here exists twice. There is the HTML you may be reading, and a plain markdown file at the same URL with `.md` appended. An `llms.txt` at the root lists every post with a one-line summary, so an agent can survey the whole site in one small request instead of scraping navigation markup.
 
-This is not much work. The markdown already exists; the build just refrains from destroying it. One endpoint, a dozen lines.
+![A hand writing calligraphy with a brush and black ink](https://images.pexels.com/photos/9478289/pexels-photo-9478289.jpeg?auto=compress&cs=tinysrgb&w=1200)
 
-Formats are a courtesy. HTML for eyes, markdown for context windows, RSS for the patient. The content is the same; only the reader changes.
+<small>Photo via [Pexels](https://www.pexels.com/photo/calligraphy-using-a-blank-ink-and-paint-brush-9478289/)</small>
+
+The markdown already existed; the build publishes it instead of throwing it away. One endpoint, about a dozen lines of it.

package/src/templates/blog/src/content.config.ts

@@ -11,6 +11,9 @@ const blog = defineCollection({
     description: z.string().min(50).max(160),
     date: z.coerce.date(),
     ogImage: z.string().optional(),
+    // Draft posts build nowhere: no page, no listing, no RSS, no llms.txt.
+    // Flip to false (or remove the line) to publish.
+    draft: z.boolean().default(false),
   }),
 });
 

package/src/templates/blog/src/layouts/Base.astro

@@ -2,6 +2,8 @@
 import BaseHead from "../components/BaseHead.astro";
 import { SITE } from "../site";
 
+const isHome = Astro.url.pathname === "/";
+
 interface Props {
   title: string;
   description: string;
@@ -17,7 +19,16 @@ interface Props {
     <BaseHead {...Astro.props} />
   </head>
   <body>
-    <header><a href="/">{SITE.name}</a></header>
+    {
+      !isHome && (
+        <header>
+          <a href="/" class="mark">
+            <span class="mark-badge" transition:name="site-mark">渋み</span>
+            <span transition:name="site-title">{SITE.name}</span>
+          </a>
+        </header>
+      )
+    }
     <main>
       <slot />
     </main>

package/src/templates/blog/src/pages/index.astro

@@ -3,7 +3,7 @@ import { getCollection } from "astro:content";
 import Base from "../layouts/Base.astro";
 import { SITE } from "../site";
 
-const posts = (await getCollection("blog")).sort(
+const posts = (await getCollection("blog", ({ data }) => !data.draft)).sort(
   (a, b) => b.data.date.valueOf() - a.data.date.valueOf()
 );
 const formatDate = (date: Date) =>
@@ -12,7 +12,10 @@ const formatDate = (date: Date) =>
 
 <Base title={SITE.name} description={SITE.description}>
   <article>
-    <h1>{SITE.name}</h1>
+    <h1 class="home-title">
+      <span class="mark-badge" transition:name="site-mark">渋み</span>
+      <span transition:name="site-title">{SITE.name}</span>
+    </h1>
     <ul class="posts">
       {
         posts.map((post) => (

package/src/templates/blog/src/pages/llms.txt.ts

@@ -5,7 +5,7 @@ import { getCollection } from "astro:content";
 import { SITE } from "../site";
 
 export const GET: APIRoute = async (context) => {
-  const posts = (await getCollection("blog")).sort(
+  const posts = (await getCollection("blog", ({ data }) => !data.draft)).sort(
     (a, b) => b.data.date.valueOf() - a.data.date.valueOf()
   );
   const lines = [

package/src/templates/blog/src/pages/posts/[id].astro

@@ -3,7 +3,7 @@ import { getCollection, render } from "astro:content";
 import Base from "../../layouts/Base.astro";
 
 export async function getStaticPaths() {
-  return (await getCollection("blog")).map((post) => ({
+  return (await getCollection("blog", ({ data }) => !data.draft)).map((post) => ({
     params: { id: post.id },
     props: { post },
   }));
@@ -27,5 +27,6 @@ const formatDate = (date: Date) =>
     <h1>{post.data.title}</h1>
     <p class="lede">{post.data.description}</p>
     <Content />
+    <p class="post-end"><a class="ghost-pill" href="/">← Back to the blog</a></p>
   </article>
 </Base>

package/src/templates/blog/src/pages/posts/[id].md.ts

@@ -4,7 +4,7 @@ import { getCollection, getEntry } from "astro:content";
 import type { APIRoute } from "astro";
 
 export async function getStaticPaths() {
-  return (await getCollection("blog")).map((post) => ({ params: { id: post.id } }));
+  return (await getCollection("blog", ({ data }) => !data.draft)).map((post) => ({ params: { id: post.id } }));
 }
 
 export const GET: APIRoute = async ({ params }) => {

package/src/templates/blog/src/pages/rss.xml.ts

@@ -4,7 +4,7 @@ import { getCollection } from "astro:content";
 import { SITE } from "../site";
 
 export const GET: APIRoute = async (context) => {
-  const posts = (await getCollection("blog")).sort(
+  const posts = (await getCollection("blog", ({ data }) => !data.draft)).sort(
     (a, b) => b.data.date.valueOf() - a.data.date.valueOf()
   );
   return rss({

package/src/templates/full-stack/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><style>text{fill:#e95f19;font-family:"Hiragino Sans","Noto Sans JP",sans-serif}@media (prefers-color-scheme:dark){text{fill:#ff8648}}</style><text x="50" y="55" font-size="62" text-anchor="middle" dominant-baseline="central">渋</text></svg>

package/src/templates/full-stack/public/style.css

@@ -2,6 +2,12 @@
    Edit freely; this file is yours. Tokens: --paper --ink --muted --line
    --accent, type scale --text-xs..--text-2xl, --font-sans/serif/mono. */
 
+/* The vendored shibumi.css sets a kozo paper background for the sites; apps
+   stay flat, and this override also stops the browser fetching the image. */
+body {
+  background-image: none;
+}
+
 .scaffold {
   max-width: 40.625rem;
   margin: 0 auto;
@@ -83,7 +89,7 @@
   border-top: 1px solid var(--line);
 }
 
-main .endpoints a {
+main .endpoints a:not(.btn):not(.button) {
   display: flex;
   align-items: baseline;
   justify-content: space-between;
@@ -95,13 +101,12 @@ main .endpoints a {
   transition: background 160ms ease;
 }
 
-main .endpoints a:hover,
-main .endpoints a:focus-visible {
+main .endpoints a:not(.btn):not(.button):hover,
+main .endpoints a:not(.btn):not(.button):focus-visible {
   background: var(--faint);
 }
 
-.endpoint-path {
-  font-family: var(--font-mono);
+main .endpoints code {
   font-size: var(--text-sm);
 }
 /* Inline code as rounded chips on the faint layer. */
@@ -114,7 +119,7 @@ main .endpoints a:focus-visible {
 }
 
 
-main .endpoints a:hover .endpoint-path {
+main .endpoints a:hover code {
   color: var(--accent);
 }
 

package/src/templates/full-stack/public/vendor/shibumi.css

@@ -60,19 +60,23 @@ body {
     background: var(--bg);
 }
 
-h1, h2, h3 {
-    font-family: var(--font-serif);
+/* Kozo paper texture, light theme only; dark stays flat ink. The image lives
+   next to this stylesheet in every consumer, hence the relative URL. */
+body {
+    background-image: url("kozo.webp");
+    background-size: cover;
+    background-position: center;
+    background-attachment: fixed;
+    background-repeat: no-repeat;
 }
+@media (prefers-color-scheme: dark) {
+    body { background-image: none; }
+}
+[data-theme="light"] body { background-image: url("kozo.webp"); }
+[data-theme="dark"] body { background-image: none; }
 
-/* theme-independent noise texture, copied from shibumi-server */
-body::before {
-    content: "";
-    position: fixed;
-    inset: 0;
-    z-index: -1;
-    pointer-events: none;
-    opacity: 0.33;
-    background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 180 180' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.88' numOctaves='3' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='.08'/%3E%3C/svg%3E");
+h1, h2, h3 {
+    font-family: var(--font-serif);
 }
 
 a { color: inherit; }
@@ -123,9 +127,9 @@ main a:not(.btn):not(.button):focus-visible {
     width: 100vw;
     height: 100%;
     transform: translateX(-50%);
-    background: light-dark(rgb(245 240 228 / 78%), rgb(27 19 15 / 72%));
-    backdrop-filter: blur(1.125rem);
-    -webkit-backdrop-filter: blur(1.125rem);
+    background: light-dark(rgb(245 240 228 / 0%), rgb(27 19 15 / 72%));
+    backdrop-filter: blur(1.25rem);
+    -webkit-backdrop-filter: blur(1.25rem);
 }
 
 .mark {

package/src/templates/full-stack/src/app.ts

@@ -107,6 +107,8 @@ const page = `<!doctype html>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>Full Stack app · shibumi</title>
+    <link rel="icon" type="image/svg+xml" href="/public/favicon.svg" />
+    <meta name="generator" content="create-shibumi (shibumistack.dev)" />
     <link rel="stylesheet" href="/public/vendor/shibumi.css" />
     <link rel="stylesheet" href="/public/style.css" />
     <!-- app.js must load before Alpine so the alpine:init listener exists
@@ -125,9 +127,9 @@ const page = `<!doctype html>
         <span class="demo-hint">stored in SQLite; reloads and deploys keep it</span>
       </section>
       <ul class="endpoints">
-        <li><a href="/api/hello?name=you"><span class="endpoint-path">GET /api/hello</span><span>query validated with Zod</span></a></li>
-        <li><a href="/api/notes"><span class="endpoint-path">GET /api/notes</span><span>Drizzle read from SQLite on the data volume</span></a></li>
-        <li><a href="/healthz"><span class="endpoint-path">GET /healthz</span><span>the check every deploy waits for</span></a></li>
+        <li><a href="/api/hello?name=you"><code>GET /api/hello</code><span>query validated with Zod</span></a></li>
+        <li><a href="/api/notes"><code>GET /api/notes</code><span>Drizzle read from SQLite on the data volume</span></a></li>
+        <li><a href="/healthz"><code>GET /healthz</code><span>the check every deploy waits for</span></a></li>
       </ul>
       <footer class="colophon">
         <p>This page lives in <code>src/app.ts</code>. House rules for coding agents are in <code>agents.md</code>. Add features with <code>bun shi add auth</code>.</p>