@voltro/cli 0.52.0 → 0.53.0

package/templates/apps/frontend-static-blog/src/pages/blog/[slug]/page.tsx

@@ -1,9 +1,11 @@
 // A dynamic route — `/blog/<slug>` — pre-rendered STATICALLY, one HTML
 // file per post. Three exports make that work:
 //
-//   • getStaticPaths  → enumerate which slugs to build (from the content
-//                        source; point it at a CMS/DB in a real app).
-//   • loader          → fetch THIS post's data; runs at build per slug.
+//   • getStaticPaths  → enumerate which slugs to build (from the `posts`
+//                        content collection — one .md file per post).
+//   • loader          → fetch THIS post's entry; runs at build per slug and
+//                        returns the RENDERED html (code fences highlighted
+//                        server-side; nothing markdown-shaped in the bundle).
 //   • meta(loaderData)→ per-post <title>/<description> baked into the HTML.
 //
 // `interactive: 'islands'` hydrates ONLY the <ReadingProgress> island; the
@@ -11,8 +13,9 @@
 
 import type { ReactNode } from 'react'
 import { useLoaderData, notFound, type LoaderFn, type PageMeta } from '@voltro/web'
+import { getCollection, getEntry, type ContentEntry } from '@voltro/content'
 import { T, useLocale } from '@voltro/i18n'
-import { posts, type Post } from '../../../content/posts'
+import { posts, type Post } from '../../../collections/posts.collection'
 import { withLocalePrefix } from '../../../lib/locale'
 import ReadingProgress from '../../../components/ReadingProgress.island'
 
@@ -22,14 +25,13 @@ export const interactive = 'islands' as const
 // Which concrete paths to pre-render. Every returned `params` becomes one
 // built HTML file; un-enumerated slugs are simply not built (→ 404).
 export const getStaticPaths = async (): Promise<Array<{ params: { slug: string } }>> =>
-  posts.map((post) => ({ params: { slug: post.slug } }))
+  (await getCollection(posts.name)).map((post) => ({ params: { slug: post.slug } }))
 
 // Runs at build time for each enumerated slug. Returning `notFound()` skips
-// the artifact at build / 404s at runtime — defensive, though getStaticPaths
-// only ever feeds us slugs that exist.
-export const loader: LoaderFn<Post> = async ({ params }) => {
-  const post = posts.find((p) => p.slug === params.slug)
-  if (!post) return notFound(`post ${params.slug}`)
+// the artifact at build / 404s at runtime.
+export const loader: LoaderFn<ContentEntry<Post>> = async ({ params }) => {
+  const post = await getEntry<Post>(posts.name, params.slug)
+  if (post === null) return notFound(`post ${params.slug}`)
   return post
 }
 
@@ -37,15 +39,13 @@ export const loader: LoaderFn<Post> = async ({ params }) => {
 // pre-rendered HTML (great for SEO + social cards). The title/description are
 // POST CONTENT, not chrome, so they are the same on `/blog/x` and `/de/blog/x`
 // — no per-locale variant needed here.
-export const meta = ({ loaderData }: { loaderData: Post }): PageMeta => ({
-  title: `${loaderData.title} — {{capProjectName}}`,
-  description: loaderData.excerpt,
+export const meta = ({ loaderData }: { loaderData: ContentEntry<Post> }): PageMeta => ({
+  title: `${loaderData.data.title} — {{capProjectName}}`,
+  description: loaderData.data.excerpt,
 })
 
 export default function BlogPost(): ReactNode {
-  const post = useLoaderData<Post>()
-  // The active locale (from the layout's URL provider) keeps the "all posts"
-  // link on the current language.
+  const post = useLoaderData<ContentEntry<Post>>()
   const locale = useLocale()
   return (
     <main>
@@ -56,13 +56,11 @@ export default function BlogPost(): ReactNode {
         </a>
       </p>
       <article>
-        <h1>{post.title}</h1>
+        <h1>{post.data.title}</h1>
         <p className="muted">
-          {post.date} · <T id="post.readingTimeRead" values={{ minutes: post.readingMinutes }} />
+          {post.data.date} · <T id="post.readingTimeRead" values={{ minutes: post.data.readingMinutes }} />
         </p>
-        {post.body.split('\n\n').map((para, i) => (
-          <p key={i}>{para}</p>
-        ))}
+        <div dangerouslySetInnerHTML={{ __html: post.html ?? '' }} />
       </article>
     </main>
   )

package/templates/apps/frontend-static-blog/src/pages/page.test.tsx

@@ -12,10 +12,16 @@
 import { afterEach, describe, expect, test, vi } from 'vitest'
 import { act, createElement, type ReactNode } from 'react'
 import { createRoot, type Root } from 'react-dom/client'
-import { posts } from '../content/posts'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { setContentRoot } from '@voltro/content'
 import en from '../locales/en'
 import de from '../locales/de'
 
+// The list now comes from the posts CONTENT COLLECTION — point the server
+// half at this app's root and load the REAL content/posts/*.md files.
+setContentRoot(join(dirname(fileURLToPath(import.meta.url)), '..', '..'))
+
 const catalogs: Record<string, Record<string, string>> = { en, de }
 let currentLocale = 'en'
 
@@ -23,6 +29,10 @@ let currentLocale = 'en'
 const fill = (msg: string, values?: Record<string, unknown>): string =>
   values ? msg.replace(/\{(\w+)\}/g, (_, k: string) => String(values[k] ?? `{${k}}`)) : msg
 
+vi.mock('@voltro/web', () => ({
+  useLoaderData: () => entries,
+}))
+
 vi.mock('@voltro/i18n', () => ({
   // The locale catalogs call these at module top-level; identity mirrors the
   // real (compile-time-only) implementations so importing them doesn't throw.
@@ -38,7 +48,9 @@ vi.mock('@voltro/i18n', () => ({
     fill(catalogs[currentLocale]?.[id] ?? id, values),
 }))
 
-const { default: Index, meta, renderMode, interactive } = await import('./page')
+const { default: Index, meta, renderMode, interactive, loader } = await import('./page')
+// The real markdown entries, loaded through the real collection pipeline.
+const entries = await loader()
 
 ;(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true
 
@@ -83,11 +95,12 @@ describe('index — localized render', () => {
     currentLocale = 'en'
     render(createElement(Index))
     const links = Array.from(container.querySelectorAll('.post-list a'))
-    expect(links).toHaveLength(posts.length)
+    expect(links).toHaveLength(entries.length)
+    expect(entries.length).toBeGreaterThan(0)
     // Newest-first: the 2025-02-03 post precedes the 2025-01-15 one.
     expect(links[0]!.getAttribute('href')).toBe('/blog/cms-to-ssg')
     expect(links[links.length - 1]!.getAttribute('href')).toBe('/blog/hello-static')
-    expect(container.textContent).toContain(`${posts.length} posts`)
+    expect(container.textContent).toContain(`${entries.length} posts`)
   })
 
   test('prefixes post links with /de and renders German chrome (de)', () => {
@@ -95,6 +108,6 @@ describe('index — localized render', () => {
     render(createElement(Index))
     const links = Array.from(container.querySelectorAll('.post-list a'))
     expect(links[0]!.getAttribute('href')).toBe('/de/blog/cms-to-ssg')
-    expect(container.textContent).toContain(`${posts.length} Beiträge`)
+    expect(container.textContent).toContain(`${entries.length} Beiträge`)
   })
 })

package/templates/apps/frontend-static-blog/src/pages/page.tsx

@@ -1,18 +1,22 @@
 // Blog index, mounted at `/` (default locale) and mirrored at `/de` by
-// src/pages/[locale]/index.tsx. The post LIST is pure content — no
+// src/pages/[locale]/page.tsx. The post LIST is pure content — no
 // interactivity — so it ships zero JavaScript: `interactive = 'none'` strips
-// every framework <script> from the rendered HTML. The list is read from the
-// same content source the [slug] pages + getStaticPaths use.
+// every framework <script> from the rendered HTML.
+//
+// The list comes from the `posts` CONTENT COLLECTION (content/posts/*.md):
+// the loader runs at build time and reads the filesystem — markdown with
+// schema-checked frontmatter, no markdown dependency in this app.
 //
 // `meta` is a FUNCTION of `{ locale }` — that's what localises each variant's
 // <title> / <description> in the pre-rendered HTML. Post titles/excerpts are
-// CONTENT (src/content/posts.ts) and are NOT translated; only the chrome
-// (heading, count line, reading-time label) comes from the catalogs.
+// CONTENT and are NOT translated; only the chrome (heading, count line,
+// reading-time label) comes from the catalogs.
 
 import type { ReactNode } from 'react'
-import type { PageMeta } from '@voltro/web'
+import { useLoaderData, type PageMeta } from '@voltro/web'
+import { getCollection, type ContentEntry } from '@voltro/content'
 import { T, useLocale } from '@voltro/i18n'
-import { posts } from '../content/posts'
+import { posts, type Post } from '../collections/posts.collection'
 import { getCatalog, withLocalePrefix } from '../lib/locale'
 
 export const renderMode = 'static' as const
@@ -26,10 +30,13 @@ export const meta = ({ locale }: { locale: string }): PageMeta => {
   }
 }
 
-// Newest first — sort a copy so the source array stays stable.
-const byDateDesc = [...posts].sort((a, b) => b.date.localeCompare(a.date))
+// Newest first. Runs once at build time (this page is static).
+export const loader = async (): Promise<ReadonlyArray<ContentEntry<Post>>> =>
+  [...await getCollection<Post>(posts.name)]
+    .sort((a, b) => b.data.date.localeCompare(a.data.date))
 
 export default function Index(): ReactNode {
+  const entries = useLoaderData<ReadonlyArray<ContentEntry<Post>>>()
   const locale = useLocale()
   return (
     <main>
@@ -37,18 +44,18 @@ export default function Index(): ReactNode {
         <T id="home.heading" />
       </h1>
       <p className="muted">
-        <T id="home.postCount" values={{ count: posts.length }} />
+        <T id="home.postCount" values={{ count: entries.length }} />
       </p>
       <ul className="post-list">
-        {byDateDesc.map((post) => (
+        {entries.map((post) => (
           <li key={post.slug}>
-            <a href={withLocalePrefix(`/blog/${post.slug}`, locale)}>{post.title}</a>
+            <a href={withLocalePrefix(`/blog/${post.slug}`, locale)}>{post.data.title}</a>
             <p>
               <span className="muted">
-                {post.date} · <T id="post.readingTime" values={{ minutes: post.readingMinutes }} />
+                {post.data.date} · <T id="post.readingTime" values={{ minutes: post.data.readingMinutes }} />
               </span>
               {' — '}
-              {post.excerpt}
+              {post.data.excerpt}
             </p>
           </li>
         ))}

package/templates/apps/frontend-status/package.json

@@ -12,18 +12,18 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.52.0",
-    "@voltro/cli": "0.52.0",
-    "@voltro/client": "0.52.0",
-    "@voltro/env": "0.52.0",
-    "@voltro/i18n": "0.52.0",
-    "@voltro/ui-shadcn": "0.52.0",
-    "@voltro/web": "0.52.0",
+    "@{{projectName}}/api": "0.53.0",
+    "@voltro/cli": "0.53.0",
+    "@voltro/client": "0.53.0",
+    "@voltro/env": "0.53.0",
+    "@voltro/i18n": "0.53.0",
+    "@voltro/ui-shadcn": "0.53.0",
+    "@voltro/web": "0.53.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.52.0",
+    "@voltro/devtools": "0.53.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "jsdom": "^30.0.0",

package/templates/apps/mobile-app/package.json

@@ -15,9 +15,9 @@
   "dependencies": {
     "@react-native-async-storage/async-storage": "1.23.1",
     "@react-native-community/netinfo": "11.4.1",
-    "@voltro/client": "0.52.0",
-    "@voltro/react-native": "0.52.0",
-    "@{{projectName}}/api": "0.52.0",
+    "@voltro/client": "0.53.0",
+    "@voltro/react-native": "0.53.0",
+    "@{{projectName}}/api": "0.53.0",
     "expo": "^52.0.0",
     "expo-constants": "~17.0.0",
     "expo-linking": "~7.0.0",
@@ -32,7 +32,7 @@
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
     "@vitest/coverage-v8": "^4.1.10",
-    "@voltro/cli": "0.52.0",
+    "@voltro/cli": "0.53.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/dist/apiBuild-BYBpL7Pz.js

@@ -1,2 +0,0 @@
-import { c as e, l as t } from "./apiBuild-CSFI8QGq.js";
-export { e as runApiBuild, t as runServeBundleBuild };