feat(ci,docs): setup ci + style docs

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets).
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md).

.changeset/config.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.4/schema.json",
+  "changelog": ["@changesets/changelog-github", { "repo": "ilyichv/campfire" }],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": [],
+  "privatePackages": {
+    "version": false,
+    "tag": false
+  }
+}

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.3
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Lint
+        run: bun run check
+
+      - name: Build
+        run: bunx turbo run build
+
+      - name: Type-check and test
+        run: bunx turbo run check-types test

.github/workflows/release.yml

@@ -0,0 +1,36 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.3
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Create release PR or publish to npm
+        uses: changesets/action@v1
+        with:
+          version: bun run version
+          publish: bun run release
+          commit: "chore: release"
+          title: "chore: release"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing to Campfire
+
+Thanks for your interest in Campfire!
+
+## Setup
+
+Campfire is a [Bun](https://bun.sh) + [Turborepo](https://turborepo.dev)
+monorepo.
+
+```sh
+bun install
+bun dev        # docs app + watch builds
+bun run build  # build everything
+```
+
+## Repository layout
+
+- `packages/core` — project engine: discovery, validation, mutations
+- `packages/app` — browser shell and local runtime (Vite)
+- `packages/cli` — the `camp` command line and init templates
+- `registry/` — shadcn-compatible registry items
+- `apps/docs` — docs site (Next.js + fumadocs), serves the registry at `/r`
+- `examples/` — example decks
+
+## Checks
+
+Run these before opening a PR (CI enforces them):
+
+```sh
+bun run check        # lint/format (ultracite)
+bun run fix          # auto-fix lint/format issues
+bun run check-types  # typescript
+bun run test         # bun test via turbo
+bun run build
+```
+
+## Changesets
+
+User-facing changes to `packages/*` need a changeset:
+
+```sh
+bunx changeset
+```
+
+Pick the affected packages and a semver bump, describe the change, and commit
+the generated file with your PR. Docs-only or internal changes don't need one.
+Releases are automated: merging the release PR that the changesets action
+opens on `main` publishes to npm.
+
+## Registry items
+
+Items live in `registry/items` and follow the
+[components.build](https://components.build) standard. `bun run registry:build`
+regenerates `apps/docs/public/r`, which is committed.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ilyich Vismara
+
+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.

SECURITY.md

@@ -0,0 +1,11 @@
+# Security Policy
+
+If you discover a security vulnerability in Campfire, please report it
+privately — do not open a public issue.
+
+- Email: ilyich@arkemis.it
+- Or use GitHub's private vulnerability reporting on this repository.
+
+You'll get an acknowledgement as soon as possible. Please include a
+description of the issue, steps to reproduce, and the affected package and
+version.

apps/docs/app/(home)/page.tsx

@@ -1,28 +1,44 @@
+import Image from "next/image";
 import Link from "next/link";
 
 export default function HomePage() {
   return (
-    <div className="flex flex-1 flex-col items-center justify-center gap-6 px-6 text-center">
-      <span aria-hidden className="text-6xl">
-        🔥
-      </span>
-      <h1 className="font-bold text-4xl tracking-tight">Campfire</h1>
-      <p className="max-w-xl text-fd-muted-foreground text-lg">
+    <div className="relative flex flex-1 flex-col items-center justify-center gap-6 overflow-hidden px-6 text-center">
+      <div
+        aria-hidden
+        className="cf-glow pointer-events-none absolute top-[8%] left-1/2 h-72 w-72 -translate-x-1/2 rounded-full bg-fd-primary/25 blur-3xl"
+      />
+      <div className="cf-rise cf-float relative">
+        <Image
+          alt="Campfire logo: a campfire wearing a cowboy hat"
+          height={168}
+          priority
+          src="/logo.png"
+          width={168}
+        />
+      </div>
+      <h1 className="cf-rise font-display font-semibold text-5xl tracking-tight [animation-delay:90ms] sm:text-6xl">
+        Campfire
+      </h1>
+      <p className="cf-rise max-w-xl text-fd-muted-foreground text-lg [animation-delay:160ms]">
         A filesystem-native presentation runtime. Write slides in MDX, shape the
         story with React layouts, and present from a live local shell.
       </p>
-      <pre className="rounded-lg border bg-fd-secondary px-6 py-3 text-left text-sm">
+      <pre className="cf-rise rounded-lg border border-fd-border bg-fd-card px-6 py-3 text-left text-sm shadow-sm [animation-delay:230ms]">
+        <span aria-hidden className="select-none text-fd-primary">
+          ${" "}
+        </span>
         bunx @campfire/cli init my-deck
       </pre>
-      <div className="flex gap-4">
+      <div className="cf-rise flex gap-4 [animation-delay:300ms]">
         <Link
-          className="rounded-full bg-fd-primary px-6 py-2 font-medium text-fd-primary-foreground text-sm"
+          className="rounded-full bg-fd-primary px-6 py-2 font-medium text-fd-primary-foreground text-sm transition-transform hover:scale-[1.03]"
           href="/docs"
         >
           Documentation
         </Link>
         <Link
-          className="rounded-full border px-6 py-2 font-medium text-sm"
+          className="rounded-full border border-fd-border px-6 py-2 font-medium text-sm transition-colors hover:bg-fd-accent"
           href="/docs/registry"
         >
           Registry

apps/docs/app/global.css

@@ -5,13 +5,67 @@
 /* Registry items are rendered live in the docs; include their classes. */
 @source "../../../registry/items";
 
-/* Default campfire theme tokens, scoped to registry previews. Previews keep
- * the slide's own (light) theme regardless of the docs color scheme. */
-.cf-slide-frame {
-  --color-background: oklch(1 0 0);
-  --color-foreground: oklch(0.15 0 0);
-  --color-primary: oklch(0.55 0.2 260);
-  --color-muted: oklch(0.55 0.02 260);
+@theme {
+  --font-sans: var(--font-karla), ui-sans-serif, system-ui, sans-serif;
+  --font-display: var(--font-fraunces), ui-serif, Georgia, serif;
+}
+
+/* Campfire palette, sampled from the logo: ember flame, espresso logs,
+ * parchment sticker border. Light mode is daybreak camp; dark is the
+ * night around the fire. */
+:root {
+  --color-fd-background: oklch(0.972 0.014 85);
+  --color-fd-foreground: oklch(0.28 0.04 55);
+  --color-fd-muted: oklch(0.93 0.018 80);
+  --color-fd-muted-foreground: oklch(0.5 0.035 55);
+  --color-fd-popover: oklch(0.985 0.01 85);
+  --color-fd-popover-foreground: oklch(0.28 0.04 55);
+  --color-fd-card: oklch(0.95 0.018 82);
+  --color-fd-card-foreground: oklch(0.28 0.04 55);
+  --color-fd-border: oklch(0.84 0.035 75 / 60%);
+  --color-fd-primary: oklch(0.6 0.185 38);
+  --color-fd-primary-foreground: oklch(0.985 0.012 85);
+  --color-fd-secondary: oklch(0.92 0.025 78);
+  --color-fd-secondary-foreground: oklch(0.32 0.045 50);
+  --color-fd-accent: oklch(0.89 0.04 70 / 60%);
+  --color-fd-accent-foreground: oklch(0.32 0.05 45);
+  --color-fd-ring: oklch(0.6 0.185 38);
+}
+
+.dark {
+  --color-fd-background: oklch(0.17 0.012 50);
+  --color-fd-foreground: oklch(0.93 0.02 80);
+  --color-fd-muted: oklch(0.235 0.015 50);
+  --color-fd-muted-foreground: oklch(0.72 0.028 65);
+  --color-fd-popover: oklch(0.215 0.014 50);
+  --color-fd-popover-foreground: oklch(0.9 0.02 80);
+  --color-fd-card: oklch(0.2 0.014 50);
+  --color-fd-card-foreground: oklch(0.93 0.02 80);
+  --color-fd-border: oklch(0.5 0.035 55 / 25%);
+  --color-fd-primary: oklch(0.68 0.175 42);
+  --color-fd-primary-foreground: oklch(0.16 0.02 50);
+  --color-fd-secondary: oklch(0.245 0.018 50);
+  --color-fd-secondary-foreground: oklch(0.93 0.02 80);
+  --color-fd-accent: oklch(0.33 0.03 50 / 50%);
+  --color-fd-accent-foreground: oklch(0.91 0.03 75);
+  --color-fd-ring: oklch(0.68 0.175 42);
+}
+
+.dark #nd-sidebar {
+  --color-fd-muted: oklch(0.25 0.016 50);
+  --color-fd-secondary: oklch(0.27 0.018 50);
+  --color-fd-muted-foreground: oklch(0.74 0.028 65);
+}
+
+/* Headings carry the brand serif. Inside slide previews, SlideFrame
+ * re-points --font-display at the deck's own font stack. */
+.prose :is(h1, h2, h3, h4) {
+  font-family: var(--font-display);
+}
+
+.font-display {
+  font-family: var(--font-display);
+  letter-spacing: -0.01em;
 }
 
 html {
@@ -22,3 +76,57 @@ html > body[data-scroll-locked] {
   --removed-body-scroll-bar-size: 0px !important;
   margin-right: 0px !important;
 }
+
+/* Home hero: staggered rise on load, gentle float and ember glow after. */
+@keyframes cf-rise {
+  from {
+    opacity: 0;
+    transform: translateY(14px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@keyframes cf-float {
+  0%,
+  100% {
+    transform: translateY(0);
+  }
+  50% {
+    transform: translateY(-7px);
+  }
+}
+
+@keyframes cf-glow {
+  0%,
+  100% {
+    opacity: 0.55;
+    transform: scale(1);
+  }
+  50% {
+    opacity: 0.85;
+    transform: scale(1.08);
+  }
+}
+
+.cf-rise {
+  animation: cf-rise 0.7s cubic-bezier(0.2, 0.7, 0.2, 1) both;
+}
+
+.cf-float {
+  animation: cf-float 6s ease-in-out infinite;
+}
+
+.cf-glow {
+  animation: cf-glow 5s ease-in-out infinite;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .cf-rise,
+  .cf-float,
+  .cf-glow {
+    animation: none;
+  }
+}