@anja.codes/create-vitakit 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anja Ressmann, Benjamin Hackl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# @anja.codes/create-vitakit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Scaffold a [vitakit](https://github.com/anja-codes/vitakit) project: an academic
+website and a LaTeX CV built from one set of files.
+
+```bash
+pnpm create @anja.codes/vitakit my-site
+cd my-site
+pnpm install
+pnpm dev            # http://localhost:3000
+pnpm build:cv       # cv-tex/cv.pdf (needs a TeX distribution)
+pnpm check          # what CI runs
+```
+
+It asks for your name, position, affiliation, email and a deployment target
+(GitHub Pages, Cloudflare Pages, rsync, or none), copies the template and
+substitutes those few values.
+
+This is the only scaffolding step vitakit has. Everything afterwards — a new
+page, a new CV variant, a new section — is adding or copying a file in a
+repository you own.
+
+MIT

package/index.mjs

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+/**
+ * pnpm create @anja.codes/vitakit [directory]
+ *
+ * Copies the template, substitutes the few things that are personal, and picks
+ * a deployment workflow. Deliberately the *only* scaffolding step vitakit has:
+ * everything afterwards is editing files in a repository you own.
+ */
+import { cp, mkdir, readdir, readFile, rename, rm, writeFile } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { basename, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { createInterface } from 'node:readline/promises'
+import process from 'node:process'
+
+const TEMPLATE = fileURLToPath(new URL('template', import.meta.url))
+
+const DEPLOYMENTS = {
+  'github-pages': { label: 'GitHub Pages (public repository)', keep: ['deploy.yml', 'cv.yml'], host: '_github' },
+  'cloudflare': { label: 'Cloudflare Pages (works with a private repository)', keep: ['cloudflare.yml', 'cv.yml'], host: '_github' },
+  'rsync': { label: 'Web space via rsync (Forgejo)', keep: ['deploy.yml'], host: '_forgejo' },
+  'none': { label: 'None for now', keep: [], host: undefined },
+}
+
+function slugify(value) {
+  return value.normalize('NFKD').replace(/[\u0300-\u036f]/g, '')
+    .toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '') || 'my-site'
+}
+
+/** Replace the placeholders the template uses. */
+function fill(text, answers) {
+  return text
+    .replaceAll('__NAME__', answers.name)
+    .replaceAll('__TITLE__', answers.title)
+    .replaceAll('__AFFILIATION__', answers.affiliation)
+    .replaceAll('__EMAIL__', answers.email)
+    .replaceAll('__SLUG__', answers.slug)
+}
+
+const TEXT_FILE = /\.(md|ya?ml|json|ts|vue|css|bib|tex|svg|txt|yml|template)$/
+
+async function scaffold(target, answers) {
+  await mkdir(target, { recursive: true })
+  await cp(TEMPLATE, target, { recursive: true })
+
+  // Files that cannot be shipped under their final name: `.gitignore` is
+  // excluded by npm, and `package.json` would make the template a workspace.
+  for (const [from, to] of [['.gitignore.template', '.gitignore'], ['package.json.template', 'package.json']]) {
+    await rename(join(target, from), join(target, to))
+  }
+
+  const deployment = DEPLOYMENTS[answers.deployment]
+  for (const [dir, name] of [['_github', '.github'], ['_forgejo', '.forgejo']]) {
+    const path = join(target, dir)
+    if (deployment.host !== dir) {
+      await rm(path, { recursive: true, force: true })
+      continue
+    }
+    const workflows = join(path, 'workflows')
+    for (const file of await readdir(workflows)) {
+      if (!deployment.keep.includes(file)) await rm(join(workflows, file))
+    }
+    await rename(path, join(target, name))
+  }
+
+  // Substitute placeholders in every text file.
+  const walk = async (dir) => {
+    for (const item of await readdir(dir, { withFileTypes: true })) {
+      const path = join(dir, item.name)
+      if (item.isDirectory()) await walk(path)
+      else if (TEXT_FILE.test(item.name) || item.name === 'package.json' || item.name === '.gitignore') {
+        await writeFile(path, fill(await readFile(path, 'utf8'), answers))
+      }
+    }
+  }
+  await walk(target)
+}
+
+async function main() {
+  const [directoryArgument] = process.argv.slice(2).filter(argument => !argument.startsWith('-'))
+  const interactive = process.stdin.isTTY && !process.env.VITAKIT_CREATE_DEFAULTS
+
+  const answers = {
+    name: 'Your Name',
+    title: 'Postdoctoral Researcher',
+    affiliation: 'Department of Mathematics, University of Graz',
+    email: 'you@example.org',
+    deployment: 'github-pages',
+  }
+
+  let directory = directoryArgument
+
+  if (interactive) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout })
+    const ask = async (question, fallback) => {
+      const answer = (await rl.question(`${question} (${fallback}) `)).trim()
+      return answer || fallback
+    }
+
+    console.log('\nvitakit — a website and a LaTeX CV from one set of files.\n')
+    answers.name = await ask('Your name:', answers.name)
+    answers.title = await ask('Your position:', answers.title)
+    answers.affiliation = await ask('Affiliation:', answers.affiliation)
+    answers.email = await ask('Email:', answers.email)
+    directory ??= await ask('Directory:', slugify(answers.name))
+
+    console.log('\nDeployment:')
+    const keys = Object.keys(DEPLOYMENTS)
+    keys.forEach((key, index) => console.log(`  ${index + 1}. ${DEPLOYMENTS[key].label}`))
+    const choice = await ask('Choose:', '1')
+    answers.deployment = keys[Number(choice) - 1] ?? 'github-pages'
+
+    rl.close()
+  }
+
+  directory ??= slugify(answers.name)
+  answers.slug = slugify(basename(directory))
+  const target = resolve(process.cwd(), directory)
+
+  if (existsSync(target) && (await readdir(target)).length) {
+    throw new Error(`${directory} already exists and is not empty`)
+  }
+
+  await scaffold(target, answers)
+
+  console.log(`\nCreated ${directory}\n`)
+  console.log('  cd ' + directory)
+  console.log('  pnpm install')
+  console.log('  pnpm dev            # http://localhost:3000')
+  console.log('  pnpm build:cv       # cv-tex/cv.pdf (needs LaTeX)')
+  console.log('  pnpm check          # what CI runs\n')
+  console.log('Then edit content/: profile.yml, the section files and publications.bib.')
+  console.log('The PDF is not part of the website build; assume this repository is private.\n')
+}
+
+main().catch((error) => {
+  console.error(`\n@anja.codes/create-vitakit: ${error instanceof Error ? error.message : String(error)}\n`)
+  process.exit(1)
+})

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@anja.codes/create-vitakit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Scaffold a vitakit project: an academic website and a LaTeX CV from one set of files.",
+  "license": "MIT",
+  "keywords": [
+    "vitakit",
+    "create",
+    "scaffold",
+    "cv",
+    "academic",
+    "nuxt",
+    "latex"
+  ],
+  "homepage": "https://github.com/anja-codes/vitakit/tree/main/create#readme",
+  "bugs": {
+    "url": "https://github.com/anja-codes/vitakit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anja-codes/vitakit.git",
+    "directory": "create"
+  },
+  "type": "module",
+  "bin": {
+    "create-vitakit": "index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "template",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/template/.gitignore.template

@@ -0,0 +1,19 @@
+# Nuxt
+.output
+.nuxt
+.data
+.nitro
+.cache
+dist
+node_modules
+
+# vitakit / latexmk output
+# Everything generated lives in cv-tex/generated/ (the .cls and all auxiliary
+# files included); only the finished PDF is written beside the sources.
+cv-tex/generated
+cv-tex/*.pdf
+
+# Misc
+*.log
+.DS_Store
+.env

package/template/_forgejo/workflows/deploy.yml

@@ -0,0 +1,31 @@
+# Builds the site and deploys it to web space via rsync.
+#
+# Secret: SSH_DEPLOY_KEY (private key with write access to the target).
+# Adjust NUXT_APP_BASE_URL and the rsync target below.
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    env:
+      NUXT_APP_BASE_URL: /
+    steps:
+      - uses: https://github.com/actions/checkout@v7
+      - run: apt update && apt install -y rsync
+      - uses: https://github.com/pnpm/action-setup@v6
+      # The runner image may ship an older Node than Nuxt requires.
+      - uses: https://github.com/actions/setup-node@v7
+        with:
+          node-version: 22
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm check
+      - uses: https://github.com/webfactory/ssh-agent@v0.9.0
+        with:
+          ssh-private-key: ${{ secrets.SSH_DEPLOY_KEY }}
+      - run: |
+          rsync -e "ssh -o StrictHostKeyChecking=no" -av --delete \
+            .output/public/ user@example.org:/var/www/your-site/

package/template/_github/workflows/cloudflare.yml

@@ -0,0 +1,31 @@
+# Builds the site and deploys it to Cloudflare Pages.
+#
+# Recommended when the repository is private: Cloudflare Pages builds from
+# private repositories on the free tier, which GitHub Pages does not.
+#
+# Secrets: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID.
+# Set `projectName` to your Pages project.
+name: Deploy (Cloudflare Pages)
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 22
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm check
+      - uses: cloudflare/wrangler-action@v4
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy .output/public --project-name=__SLUG__

package/template/_github/workflows/cv.yml

@@ -0,0 +1,36 @@
+# Builds the PDF CV and attaches it to the workflow run.
+#
+# The PDF is an artifact, not part of the website: it may contain entries
+# marked `visibility: cv` (address, phone, referees). Download it from the run
+# summary. Runs on demand, and on pushes that touch CV material.
+name: CV
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths: ['content/**', 'cv-tex/**']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 22
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      # Generate the .tex files here: the LaTeX action runs in its own container,
+      # without Node. cv-tex/latexmkrc lets it find the generated document class.
+      - run: pnpm build:cv --no-pdf
+      - uses: xu-cheng/latex-action@v4
+        with:
+          working_directory: cv-tex
+          root_file: cv.tex
+          latexmk_use_lualatex: false
+      - uses: actions/upload-artifact@v5
+        with:
+          name: cv
+          path: cv-tex/*.pdf

package/template/_github/workflows/deploy.yml

@@ -0,0 +1,53 @@
+# Builds the site and publishes it to GitHub Pages.
+#
+# Setup: Settings -> Pages -> Source: "GitHub Actions".
+#
+# NUXT_APP_BASE_URL must match where the site is served from. For a project
+# site at https://<user>.github.io/<repo>/ keep the line below; for a user site
+# or a custom domain, delete it. A wrong value breaks every asset URL.
+name: Deploy
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      NUXT_APP_BASE_URL: /${{ github.event.repository.name }}/
+    steps:
+      - uses: actions/checkout@v7
+      # No `version:` here: the pnpm version comes from `packageManager` in
+      # package.json. Setting both fails with ERR_PNPM_BAD_PM_VERSION.
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 22        # keep in sync with engines.node
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      # typecheck + generate + assertions on the generated HTML
+      - run: pnpm check
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: .output/public
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v5

package/template/app/app.vue

@@ -0,0 +1,5 @@
+<template>
+  <NuxtLayout>
+    <NuxtPage />
+  </NuxtLayout>
+</template>

package/template/app/assets/css/main.css

@@ -0,0 +1,117 @@
+@import "tailwindcss";
+
+/* Design tokens: the first stop for restyling. Tailwind v4 reads these, so
+   `text-primary` and `font-serif` follow from here. */
+@theme {
+  --font-sans: "Inter", ui-sans-serif, system-ui, sans-serif;
+  --font-serif: "Lora", ui-serif, Georgia, serif;
+  --color-primary: oklch(48% 0.13 250);
+}
+
+body {
+  @apply font-sans text-neutral-900 antialiased;
+}
+
+a {
+  @apply text-primary underline underline-offset-2 hover:no-underline;
+}
+
+/* --- vitakit components ------------------------------------------------ */
+
+.vita-entry {
+  @apply grid gap-1 py-2 sm:grid-cols-[8rem_1fr] sm:gap-4;
+}
+.vita-entry__date {
+  @apply text-sm text-neutral-500 tabular-nums;
+}
+.vita-entry__title {
+  @apply font-medium;
+}
+.vita-entry__meta,
+.vita-entry__note {
+  @apply text-sm text-neutral-600;
+}
+.vita-section {
+  @apply divide-y divide-neutral-100;
+}
+.vita-links {
+  @apply flex flex-wrap gap-x-4 gap-y-1;
+}
+.vita-publications__group + .vita-publications__group {
+  @apply mt-8;
+}
+.vita-publications__heading {
+  @apply text-xl font-semibold;
+}
+.vita-bib {
+  @apply mt-3 list-decimal space-y-3 pl-6;
+}
+.vita-badge {
+  @apply ml-1 rounded bg-neutral-100 px-1.5 py-0.5 text-xs no-underline hover:bg-neutral-200;
+}
+.vita-issues {
+  @apply border-b border-red-300 bg-red-50 px-4 py-3 text-sm text-red-900;
+}
+.vita-issues__title {
+  @apply font-semibold;
+}
+.vita-issues pre {
+  @apply whitespace-pre-wrap font-sans;
+}
+
+/* --- Markdown output --------------------------------------------------- */
+
+.vita-prose {
+  @apply leading-relaxed;
+}
+.vita-prose :where(p, ul, ol, blockquote, pre, table) {
+  @apply my-4;
+}
+.vita-prose :where(h2) {
+  @apply mt-8 mb-2 text-xl font-semibold;
+}
+.vita-prose :where(h3) {
+  @apply mt-6 mb-2 text-lg font-semibold;
+}
+.vita-prose :where(ul) {
+  @apply list-disc pl-6;
+}
+.vita-prose :where(ol) {
+  @apply list-decimal pl-6;
+}
+.vita-prose :where(code) {
+  @apply rounded bg-neutral-100 px-1 py-0.5 text-sm;
+}
+.vita-prose :where(pre) {
+  @apply overflow-x-auto rounded bg-neutral-100 p-4 text-sm;
+}
+.vita-prose :where(blockquote) {
+  @apply border-l-4 border-neutral-200 pl-4 text-neutral-600;
+}
+.vita-prose :where(figure) {
+  @apply my-4;
+}
+.vita-prose :where(figcaption) {
+  @apply mt-1 text-xs text-neutral-500;
+}
+/* A figure beside the text on wide screens, above it on narrow ones. */
+.vita-prose :where(figure.figure-right) {
+  @apply sm:float-right sm:ml-6 sm:mt-0 sm:w-56;
+}
+.vita-prose :where(figure.figure-right) img {
+  @apply w-full rounded border border-neutral-200 bg-white p-2;
+}
+.vita-prose :where(table) {
+  @apply w-full border-collapse text-left text-sm;
+}
+.vita-prose :where(th, td) {
+  @apply border-b border-neutral-200 py-2 pr-4 align-top;
+}
+.vita-prose :where(th) {
+  @apply font-semibold;
+}
+
+/* Wide display formulas must not blow up the layout on narrow screens. */
+.katex-display {
+  @apply overflow-x-auto overflow-y-hidden py-1;
+}

package/template/app/layouts/default.vue

@@ -0,0 +1,39 @@
+<script setup lang="ts">
+const profile = useProfile()
+</script>
+
+<template>
+  <div class="min-h-screen flex flex-col">
+    <!-- Shows content problems while developing; a build fails on them instead. -->
+    <VitaIssues />
+
+    <header class="border-b border-neutral-200">
+      <div class="mx-auto flex max-w-3xl flex-wrap items-baseline gap-x-6 gap-y-2 px-4 py-6">
+        <NuxtLink to="/" class="text-lg font-semibold no-underline">
+          {{ profile.name }}
+        </NuxtLink>
+        <nav class="ml-auto flex gap-4 text-sm">
+          <NuxtLink
+            v-for="item in profile.nav"
+            :key="item.url"
+            :to="item.url"
+            class="no-underline hover:underline"
+          >
+            {{ item.label }}
+          </NuxtLink>
+        </nav>
+      </div>
+    </header>
+
+    <main class="mx-auto w-full max-w-3xl flex-1 px-4 py-10">
+      <slot />
+    </main>
+
+    <footer class="border-t border-neutral-200">
+      <div class="mx-auto flex max-w-3xl flex-wrap items-baseline gap-2 px-4 py-6 text-sm text-neutral-600">
+        <p>&copy; {{ new Date().getFullYear() }} {{ profile.name }}</p>
+        <VitaMarkdown class="ml-auto text-xs text-neutral-400" :html="profile.footerHtml" />
+      </div>
+    </footer>
+  </div>
+</template>

package/template/app/pages/[...slug].vue

@@ -0,0 +1,30 @@
+<script setup lang="ts">
+/**
+ * Renders every Markdown page in `content/pages/`.
+ *
+ * Adding a page means adding a file. When a page needs more than prose, create
+ * `app/pages/<name>.vue`: a concrete route always wins over this catch-all.
+ */
+const profile = useProfile()
+const route = useRoute()
+const page = usePage(route.path)
+
+if (!page) {
+  throw createError({ statusCode: 404, statusMessage: `No page for ${route.path}`, fatal: true })
+}
+
+useHead({
+  title: page.route === '/' ? profile.name : `${page.title} – ${profile.name}`,
+  meta: [{ name: 'description', content: page.description ?? profile.summary }],
+})
+</script>
+
+<template>
+  <article>
+    <h1 class="text-3xl font-semibold" v-html="page!.titleHtml" />
+    <p v-if="page!.description" class="mt-2 text-neutral-600">
+      {{ page!.description }}
+    </p>
+    <VitaMarkdown class="mt-6" :html="page!.bodyHtml" />
+  </article>
+</template>

package/template/app/pages/cv.vue

@@ -0,0 +1,39 @@
+<script setup lang="ts">
+/**
+ * The CV page: several sections composed in the order you want them.
+ *
+ * Section order, headings and which sections appear are decided here, not in
+ * the data — exactly as `cv.tex` decides them for the PDF.
+ */
+const profile = useProfile()
+const page = usePage('/cv/')!
+
+const sections = [
+  { id: 'employment', label: 'Employment' },
+  { id: 'education', label: 'Education' },
+  { id: 'teaching', label: 'Teaching' },
+  { id: 'supervision', label: 'Supervised theses' },
+  { id: 'talks', label: 'Talks' },
+]
+
+useHead({
+  title: `${page.title} – ${profile.name}`,
+  meta: [{ name: 'description', content: page.description ?? profile.summary }],
+})
+</script>
+
+<template>
+  <article>
+    <h1 class="text-3xl font-semibold">
+      {{ page.title }}
+    </h1>
+    <VitaMarkdown class="mt-6" :html="page.bodyHtml" />
+
+    <section v-for="section in sections" :key="section.id" class="mt-10">
+      <h2 class="text-xl font-semibold">
+        {{ section.label }}
+      </h2>
+      <VitaSection :id="section.id" class="mt-3" />
+    </section>
+  </article>
+</template>

package/template/app/pages/index.vue

@@ -0,0 +1,62 @@
+<script setup lang="ts">
+/**
+ * The landing page: who you are, then the prose from
+ * `content/pages/index.md`, then a few recent items.
+ *
+ * This file is yours — reorder it, delete parts, add your own markup.
+ */
+const profile = useProfile()
+const page = usePage('/')
+const talks = useSection('talks')
+
+useHead({
+  title: profile.name,
+  meta: [{ name: 'description', content: profile.summary }],
+})
+</script>
+
+<template>
+  <div>
+    <header class="flex flex-wrap items-start gap-6 sm:flex-nowrap">
+      <img
+        v-if="profile.avatar"
+        :src="profile.avatar"
+        alt=""
+        width="128"
+        height="128"
+        class="size-32 shrink-0 rounded-full object-cover ring-1 ring-neutral-200"
+      >
+      <div>
+        <h1 class="text-3xl font-semibold">
+          {{ profile.name }}
+        </h1>
+        <p v-if="profile.title" class="text-neutral-600">
+          {{ profile.title }}
+          <template v-if="profile.affiliation">
+            ·
+            <a v-if="profile.affiliation.url" :href="profile.affiliation.url">{{ profile.affiliation.name }}</a>
+            <template v-else>{{ profile.affiliation.name }}</template>
+          </template>
+        </p>
+        <p v-if="profile.email" class="mt-1 text-sm">
+          <a :href="`mailto:${profile.email}`">{{ profile.email }}</a>
+        </p>
+        <VitaLinks :links="profile.links" class="mt-2 text-sm" />
+      </div>
+    </header>
+
+    <VitaMarkdown v-if="page" class="mt-8" :html="page.bodyHtml" />
+
+    <section v-if="talks.length" class="mt-10">
+      <h2 class="text-xl font-semibold">
+        Recent talks
+      </h2>
+      <VitaSection :entries="talks" :limit="3" class="mt-3" />
+      <p class="mt-3 text-sm">
+        <NuxtLink to="/cv/#talks">
+          All talks →
+        </NuxtLink>
+      </p>
+    </section>
+  </div>
+</template>

package/template/app/pages/publications.vue

@@ -0,0 +1,25 @@
+<script setup lang="ts">
+/**
+ * Prose from `content/pages/publications.md`, then the generated list.
+ *
+ * This page shadows the Markdown catch-all for `/publications/` — the general
+ * escape hatch when a page needs prose *and* components.
+ */
+const profile = useProfile()
+const page = usePage('/publications/')!
+
+useHead({
+  title: `${page.title} – ${profile.name}`,
+  meta: [{ name: 'description', content: page.description ?? profile.summary }],
+})
+</script>
+
+<template>
+  <article>
+    <h1 class="text-3xl font-semibold">
+      {{ page.title }}
+    </h1>
+    <VitaMarkdown class="mt-6" :html="page.bodyHtml" />
+    <VitaPublications class="mt-8" />
+  </article>
+</template>

package/template/content/education.yml

@@ -0,0 +1,18 @@
+- date: { from: 2016, to: 2020 }
+  degree: PhD in Mathematics
+  institution: { name: University of Klagenfurt, url: https://www.aau.at }
+  thesis:
+    title: Cutting down random trees
+    type: Doctoral thesis
+    supervisor: { label: A. Supervisor, url: https://example.org/supervisor }
+
+- date: { from: 2014, to: 2016 }
+  degree: MSc in Mathematics (with distinction)
+  institution: University of Klagenfurt
+  thesis:
+    title: Ascent sequences and their asymptotics
+    type: Master's thesis
+
+- date: { from: 2011, to: 2014 }
+  degree: BSc in Technical Mathematics
+  institution: University of Klagenfurt

package/template/content/employment.yml

@@ -0,0 +1,18 @@
+- date: { from: 2023, to: present }
+  position: Postdoctoral Researcher
+  institution: { name: University of Graz, url: https://www.uni-graz.at }
+  project:
+    title: Asymptotics of random discrete structures
+    funder: FWF
+    grant: P 12345
+    url: https://www.fwf.ac.at
+
+- date: { from: 2020, to: 2023 }
+  position: University Assistant
+  institution: University of Klagenfurt
+
+- date: { from: 2019, to: 2019 }
+  position: Visiting Researcher
+  institution: Uppsala University
+  note: Three-month research stay with the combinatorics group.
+  visibility: cv

package/template/content/pages/cv.md

@@ -0,0 +1,9 @@
+---
+title: Curriculum Vitae
+description: The same data that produces the PDF.
+order: 30
+---
+
+Build the PDF version with `pnpm build:cv`. The sections below come from the
+YAML files in `content/`; their order is decided in `app/pages/cv.vue`, and the
+order in the PDF in `cv-tex/cv.tex`.

package/template/content/pages/index.md

@@ -0,0 +1,11 @@
+---
+title: __NAME__
+order: 0
+---
+
+Replace this page with a few sentences about yourself: it lives in
+`content/pages/index.md`, and the heading above comes from its front matter.
+
+Everything on this site comes from the files in `content/`, and the same data
+produces `cv-tex/cv.pdf`. Add a page by adding a Markdown file; add a CV
+section by adding a YAML file — `pnpm vitakit add outreach` sets one up.

package/template/content/pages/publications.md

@@ -0,0 +1,8 @@
+---
+title: Publications
+description: Grouped by status, generated from a single BibTeX file.
+order: 20
+---
+
+Preprints are on [arXiv](https://arxiv.org/a/doe_j_1). The list below is
+generated from `content/publications.bib` at build time.

package/template/content/pages/research.md

@@ -0,0 +1,32 @@
+---
+title: Research
+description: Analytic combinatorics and random discrete structures.
+order: 10
+---
+
+<figure class="figure-right">
+  <img src="/img/tree.svg" alt="A simulated random tree" width="240" height="140">
+  <figcaption>A random tree on eight nodes.</figcaption>
+</figure>
+
+My work concerns the asymptotic behaviour of large random trees. A simple
+family is described by the equation $T(z) = z\,\phi(T(z))$, whose singular
+expansion determines almost everything about the limit shape:
+
+$$
+T(z) = \tau - \gamma \sqrt{1 - z/\rho} + O(1 - z/\rho).
+$$
+
+From this, the expected height of a random tree with $n$ nodes satisfies
+
+$$
+\mathbb{E}[H_n] \sim c \sqrt{n}, \qquad n \to \infty.
+$$
+
+## Tools
+
+| Technique | Used for |
+| --- | --- |
+| Singularity analysis | asymptotics of coefficients |
+| Analytic combinatorics in several variables | multivariate limit laws |
+| Simulation | checking conjectures before proving them |

package/template/content/profile.yml

@@ -0,0 +1,34 @@
+# You, and the shape of your site. The only file that is not a CV section.
+name: __NAME__
+title: __TITLE__
+affiliation:
+  name: __AFFILIATION__
+email: __EMAIL__
+
+# Where the site is published. Only the PDF needs it, to link files on the
+# site such as /slides/talk.pdf; delete the # once you know the address.
+# url: https://yourname.github.io/
+
+# Portrait, from public/. Delete the line if you would rather not have one.
+avatar: /img/portrait.svg
+
+links:
+  - { label: ORCID, url: https://orcid.org/0000-0002-1825-0097 }
+  # - { label: GitHub, url: https://github.com/yourname }
+  # - { label: arXiv, url: https://arxiv.org/a/yourname }
+
+# One or two sentences for search engines and link previews. What visitors
+# read is content/pages/index.md, not this.
+summary: >-
+  __TITLE__ at __AFFILIATION__, working on your research area.
+
+# Navigation, in the order it should appear. Adding a page does not change
+# this list: the wording and the order are yours.
+nav:
+  - { label: About, to: / }
+  - { label: Research, to: /research/ }
+  - { label: Publications, to: /publications/ }
+  - { label: CV, to: /cv/ }
+
+# Inline Markdown, shown quietly at the bottom of every page.
+footer: Built with [vitakit](https://github.com/anja-codes/vitakit).

package/template/content/publications.bib

@@ -0,0 +1,43 @@
+% Your publication list. Export it from Zotero, JabRef or arXiv and replace the
+% examples below.
+%
+% The non-standard `status` field decides the grouping on /publications/ and in
+% the PDF: published, accepted, preprint, software or other; without it, an
+% entry is published. To change the groups:
+%     pnpm vitakit eject publications        # -> schemas/publications.ts
+%
+% `doi`, `arxiv`, `mrnumber` and `zbl` become links; `eprint` with
+% `eprinttype = {arxiv}` (or `archivePrefix`) works as `arxiv` does, so exports
+% from Zotero, JabRef or arXiv need no editing. Mathematics in titles works:
+% write $...$ as usual.
+%
+% The website formats this list with a CSL style. To change it:
+%     pnpm vitakit eject publications.csl    # -> content/publications.csl
+% or save any CSL style under that name.
+
+@article{example-published,
+  author  = {Doe, Jane and Roe, Richard},
+  title   = {The shape of large random $k$-ary trees},
+  journal = {Random Structures \& Algorithms},
+  volume  = {64},
+  pages   = {201--240},
+  year    = {2024},
+  doi     = {10.5555/12345678},
+  status  = {published},
+}
+
+@misc{example-preprint,
+  author = {Doe, Jane},
+  title  = {Sharp bounds for ascent sequences of height $h$},
+  year   = {2025},
+  arxiv  = {2501.01234},
+  status = {preprint},
+}
+
+@software{example-software,
+  author = {Doe, Jane},
+  title  = {treetools: utilities for random tree simulation},
+  url    = {https://github.com/yourname/treetools},
+  year   = {2025},
+  status = {software},
+}

package/template/content/supervision.yml

@@ -0,0 +1,12 @@
+- date: 2025
+  student: A. Student
+  ongoing: true          # still in progress
+  title: Simulating random trees with $n$ nodes
+  degree: Master's thesis
+  institution: University of Graz
+
+- date: 2024
+  student: B. Student
+  title: Ascent sequences in combinatorics
+  degree: Bachelor's thesis
+  institution: University of Graz

package/template/content/talks.yml

@@ -0,0 +1,17 @@
+- date: 2025-06-16
+  title: The shape of large random $k$-ary trees
+  event: AofA 2025
+  location: Bath, UK
+  kind: invited
+
+- date: 2024-09-03
+  title: Cutting down trees, one leaf at a time
+  event: Austrian Mathematical Society Meeting
+  location: Graz, Austria
+  kind: contributed
+
+- date: 2024-03-12
+  title: What is a random tree?
+  event: Mathematics for schools
+  location: Klagenfurt, Austria
+  kind: outreach

package/template/content/teaching.yml

@@ -0,0 +1,17 @@
+- date: 2025
+  title: Analytic Combinatorics
+  role: Lecturer
+  term: 2025S
+  institution: University of Graz
+
+- date: 2024
+  title: Discrete Mathematics
+  role: Lecturer
+  term: 2024W
+  institution: University of Graz
+
+- date: 2023
+  title: Calculus I
+  role: Teaching Assistant
+  term: 2023W
+  institution: University of Klagenfurt

package/template/cv-tex/cv.tex

@@ -0,0 +1,38 @@
+% Your CV. This file decides the ORDER of things; cv.yml decides what goes in.
+%
+% Styling: redefine the macros in preamble.tex. For deeper changes run
+%   pnpm vitakit eject vitakit-cv.cls
+% which copies the document class into cv-tex/, where it is yours to edit and
+% takes precedence. Do not edit the copy in cv-tex/generated/ -- every build
+% overwrites it.
+%
+% A variant (say, for one application) is just a copy of this file:
+%   cp cv-tex/cv.tex cv-tex/application-xyz.tex   and change \vitadocument below.
+\documentclass{vitakit-cv}
+\vitadocument{cv}
+
+% The class already loads biblatex; just point it at your .bib file.
+\addbibresource{../content/publications.bib}
+
+\input{preamble.tex}
+\input{generated/cv/profile.tex}
+
+\begin{document}
+\vitaheader
+
+% Prose (cover letters, statements) lives in cv-tex/prose/ as plain LaTeX and
+% is included with \input, not \vitasection -- \vitasection is only for
+% sections vitakit generates from content/.
+% \input{prose/research-statement.tex}
+
+\vitasection{employment}
+\vitasection{education}
+\vitasection{teaching}
+
+\section{Publications}
+\vitainput{publications}
+
+\vitasection{supervision}
+\vitasection{talks}
+
+\end{document}

package/template/cv-tex/cv.yml

@@ -0,0 +1,7 @@
+# Selection for this document. Order lives in cv.tex.
+visibility: cv        # include entries marked public and cv, not private
+
+sections:
+  talks:
+    where: { kind: invited }
+    limit: 10

package/template/cv-tex/latexmkrc

@@ -0,0 +1,5 @@
+# Lets a plain `latexmk cv.tex` (in CI, or from an editor) find the document
+# class, which `pnpm build:cv` writes to generated/<document>/. A copy in this
+# directory (`pnpm vitakit eject vitakit-cv.cls`) still wins: `.` comes first.
+# The trailing separator keeps TeX's default search path.
+$ENV{'TEXINPUTS'} = join($search_path_separator, '.', './generated//', $ENV{'TEXINPUTS'} // '');

package/template/cv-tex/preamble.tex

@@ -0,0 +1,10 @@
+% Your styling lives here. The generated files only use the macros from
+% vitakit-cv.cls, so redefining them changes the design without touching
+% anything vitakit produces.
+
+% Section headings as they should appear in this document:
+\vitasectiontitle{employment}{Employment}
+\vitasectiontitle{education}{Education}
+\vitasectiontitle{teaching}{Teaching}
+\vitasectiontitle{talks}{Selected talks}
+\vitasectiontitle{supervision}{Supervised theses}

package/template/cv-tex/prose/research-statement.tex

@@ -0,0 +1,17 @@
+% Prose for your CV and applications: plain LaTeX, written by you.
+%
+% Files in this directory are never read by the website build, which makes them
+% the right place for a cover letter, a research or teaching statement, or
+% anything else that should not end up online.
+%
+% Include one wherever you want it in a document:
+%
+%   \input{prose/research-statement.tex}
+%
+% (\vitasection is only for sections vitakit generates from content/.)
+
+\section{Research statement}
+
+Replace this text. Because it is ordinary LaTeX, anything you would normally
+write works here --- environments, figures, citations such as
+\cite{example-published}, and mathematics like $\zeta(s) = \sum_{n \ge 1} n^{-s}$.

package/template/nuxt.config.ts

@@ -0,0 +1,32 @@
+import tailwindcss from '@tailwindcss/vite'
+
+const baseURL = process.env.NUXT_APP_BASE_URL || '/'
+if (!baseURL.startsWith('/') || !baseURL.endsWith('/') || baseURL.includes('//')) {
+  throw new Error('NUXT_APP_BASE_URL must be a path with leading and trailing slashes, e.g. /my-site/')
+}
+
+export default defineNuxtConfig({
+  compatibilityDate: '2026-09-06',
+  devtools: { enabled: false },
+
+  modules: ['@nuxt/fonts', '@anja.codes/vitakit/nuxt'],
+
+  // Formulas are rendered at build time; vitakit adds the matching KaTeX
+  // stylesheet itself, so no KaTeX is installed here.
+  css: ['~/assets/css/main.css'],
+
+  vite: { plugins: [tailwindcss()] },
+
+  app: {
+    baseURL,
+    head: { htmlAttrs: { lang: 'en' } },
+  },
+
+  nitro: {
+    prerender: {
+      failOnError: true,
+      // Routes come from vitakit, so an unlinked page is still generated.
+      crawlLinks: false,
+    },
+  },
+})

package/template/package.json.template

@@ -0,0 +1,34 @@
+{
+  "name": "__SLUG__",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@10.29.1",
+  "engines": {
+    "node": ">=22.18"
+  },
+  "scripts": {
+    "dev": "nuxt dev",
+    "generate": "nuxt generate",
+    "preview": "nuxt preview",
+    "postinstall": "nuxt prepare",
+    "typecheck": "nuxt typecheck",
+    "check:static": "vitakit-check",
+    "check": "pnpm typecheck && pnpm generate && pnpm check:static",
+    "build:cv": "vitakit-build-cv"
+  },
+  "dependencies": {
+    "@anja.codes/vitakit": "^0.1.0",
+    "@nuxt/fonts": "^0.14.0",
+    "@tailwindcss/vite": "^4.3.3",
+    "nuxt": "^4.5.2",
+    "tailwindcss": "^4.3.3",
+    "vue": "^3.5.43",
+    "vue-router": "^5.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.2",
+    "typescript": "^5.9.3",
+    "vue-tsc": "^3.3.11",
+    "zod": "^4.6.5"
+  }
+}

package/template/public/img/portrait.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128" role="img" aria-label="Placeholder portrait">
+  <rect width="128" height="128" fill="#e2e8f0"/>
+  <circle cx="64" cy="50" r="23" fill="#94a3b8"/>
+  <path d="M20 128c0-27 20-44 44-44s44 17 44 44z" fill="#94a3b8"/>
+  <text x="64" y="120" font-family="system-ui, sans-serif" font-size="9" fill="#475569" text-anchor="middle">replace me</text>
+</svg>

package/template/public/img/tree.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 240 140" width="240" height="140">
+  <g stroke="#475569" stroke-width="2" fill="none">
+    <path d="M120 130 V100 M120 100 L80 70 M120 100 L160 70 M80 70 L60 40 M80 70 L100 40 M160 70 L150 40 M150 40 L140 15 M150 40 L165 15"/>
+  </g>
+  <g fill="#1d4ed8">
+    <circle cx="120" cy="100" r="4"/><circle cx="80" cy="70" r="4"/><circle cx="160" cy="70" r="4"/>
+    <circle cx="60" cy="40" r="4"/><circle cx="100" cy="40" r="4"/><circle cx="150" cy="40" r="4"/>
+    <circle cx="140" cy="15" r="4"/><circle cx="165" cy="15" r="4"/>
+  </g>
+</svg>

package/template/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./.nuxt/tsconfig.app.json" },
+    { "path": "./.nuxt/tsconfig.server.json" },
+    { "path": "./.nuxt/tsconfig.shared.json" },
+    { "path": "./.nuxt/tsconfig.node.json" }
+  ]
+}