create-raredays-app 0.1.0

package/templates/static/.storybook/main.ts

@@ -0,0 +1,77 @@
+import { dirname, resolve } from "node:path";
+import { createRequire } from "node:module";
+import type { StorybookConfig } from "@storybook/react-vite";
+import react from "@vitejs/plugin-react";
+import tailwindcss from "@tailwindcss/vite";
+
+// Storybook config for the scaffolded app.
+//
+// Loads stories from two sources, namespaced separately:
+//
+//   App/<...>                  → ../app/**/*.stories.@(ts|tsx)
+//                                ../src/**/*.stories.@(ts|tsx)
+//
+//   @raredays/components/<...> → resolved-package-root/dist/**/*.stories.js
+//
+// Framework stories are pre-compiled by the framework's build (vite
+// `preserveModules: true`) — `@/` aliases are already resolved, so
+// the consumer's Vite doesn't need any path-alias config to load
+// them. To add more framework packages with stories, add a matching
+// stories[] entry pointing at their dist/.
+//
+// We resolve `@raredays/components` via Node's module resolver rather
+// than a literal `../node_modules/...` path because pnpm hoists
+// workspace dependencies to the workspace root — under a workspace
+// install the package may not exist in the app's own node_modules at
+// all, and the literal path silently matches zero stories.
+//
+// `require.resolve("@raredays/components")` returns the package's
+// main entry (`dist/index.js`); we walk up to the package root so the
+// glob can target `dist/**/*.stories.js`. We avoid resolving
+// `@raredays/components/package.json` directly because the package's
+// `exports` map does not expose `./package.json`.
+//
+// Stories render in THIS Storybook's iframe — they inherit the
+// consumer's theme.override.css, RaredaysProvider, fonts, and any
+// other context loaded in .storybook/preview.ts. That's the whole
+// point: see how framework components look with YOUR theme applied,
+// not a generic one.
+const require = createRequire(import.meta.url);
+const componentsRoot = dirname(dirname(require.resolve("@raredays/components")));
+
+const config: StorybookConfig = {
+  framework: "@storybook/react-vite",
+  stories: [
+    {
+      directory: "../app",
+      files: "**/*.stories.@(ts|tsx)",
+      titlePrefix: "App",
+    },
+    {
+      directory: "../src",
+      files: "**/*.stories.@(ts|tsx)",
+      titlePrefix: "App",
+    },
+    {
+      directory: `${componentsRoot}/dist`,
+      files: "**/*.stories.js",
+      titlePrefix: "@raredays/components",
+    },
+  ],
+  addons: [],
+  typescript: {
+    check: false,
+    reactDocgen: "react-docgen-typescript",
+  },
+  viteFinal: async (viteConfig) => {
+    viteConfig.plugins = [...(viteConfig.plugins ?? []), react(), tailwindcss()];
+    viteConfig.resolve ??= {};
+    viteConfig.resolve.alias = {
+      ...(viteConfig.resolve.alias as Record<string, string>),
+      "@": resolve(import.meta.dirname, "../app"),
+    };
+    return viteConfig;
+  },
+};
+
+export default config;

package/templates/static/.storybook/preview.ts

@@ -0,0 +1,12 @@
+import type { Preview } from "@storybook/react-vite";
+import "../app/globals.css";
+
+const preview: Preview = {
+  parameters: {
+    controls: {
+      matchers: { color: /(background|color)$/i, date: /Date$/i },
+    },
+  },
+};
+
+export default preview;

package/templates/static/CLAUDE.md

@@ -0,0 +1,50 @@
+# Project conventions
+
+Always read `AGENTS.md` first — it lists every skill available via `@raredays/*`
+packages. Use them before authoring components, modules, or providers from
+scratch.
+
+## Quick orientation
+
+This app was scaffolded with `create-raredays-app` and consumes the RareDays
+framework via `@raredays/*` workspace deps. Conventions:
+
+- **Components**: prefer composing from `@raredays/components` (shadcn-flavored,
+  Tailwind v4, browser-tested with vitest+playwright). When you do author new
+  components, follow the patterns documented in
+  `pnpm exec skillex query --package @raredays/components`.
+- **Server logic**: use `@raredays/core`'s provider/port pattern. Identity,
+  billing, notifications, CMS, etc. are wired in `app/lib/runtime.ts` —
+  edit there to swap providers, don't sprinkle SDK calls through the codebase.
+- **Tests**: vitest. Browser-mode tests use the `.browser.test.tsx` suffix and
+  run separately from node-mode tests. Conformance harnesses live in each
+  module's `src/testing/` directory and exercise every provider against the
+  same invariants.
+- **Lint/format**: `pnpm check` runs lint + format-check + style + typecheck.
+  Pre-commit hook (if you add one) should call this.
+
+## Don't
+
+- Re-implement primitives that already exist in `@raredays/*`. Always query
+  skillex first.
+- Edit code in `node_modules/@raredays/*` directly. If a provider needs
+  changing, file a framework issue or PR upstream.
+- Commit code with failing lint/format/style/test. `pnpm check` should be
+  green before every commit.
+
+## Skillex
+
+Skills from installed `@raredays/*` packages are auto-discovered. To refresh
+the index after adding a new dependency:
+
+```sh
+pnpm exec skillex refresh
+```
+
+Query patterns:
+
+```sh
+pnpm exec skillex query --search "<concepts>"
+pnpm exec skillex query --package "@raredays/components"
+pnpm exec skillex query --topic identity
+```

package/templates/static/_claude/settings.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "_comment": "Permissive defaults — agents can iterate without prompting on routine dev actions. Anything that mutates shared/remote state still requires explicit approval.",
+  "permissions": {
+    "allow": [
+      "Bash(pnpm install*)",
+      "Bash(pnpm run *)",
+      "Bash(pnpm exec *)",
+      "Bash(pnpm dev*)",
+      "Bash(pnpm build*)",
+      "Bash(pnpm test*)",
+      "Bash(pnpm lint*)",
+      "Bash(pnpm format*)",
+      "Bash(pnpm style*)",
+      "Bash(pnpm check*)",
+      "Bash(pnpm typecheck*)",
+      "Bash(pnpm db:*)",
+      "Bash(pnpm theme:build*)",
+      "Bash(pnpm dlx *)",
+      "Bash(pnpm --filter *)",
+      "Bash(pnpm -w *)",
+      "Bash(node *)",
+      "Bash(npx *)",
+      "Bash(git status*)",
+      "Bash(git diff*)",
+      "Bash(git log*)",
+      "Bash(git show*)",
+      "Bash(git branch*)",
+      "Bash(git ls-files*)",
+      "Bash(git ls-tree*)",
+      "Bash(git stash*)",
+      "Bash(git add*)",
+      "Bash(git checkout *)",
+      "Bash(git switch *)",
+      "Bash(git restore *)",
+      "Bash(git rev-parse*)",
+      "Bash(git remote -v)",
+      "Bash(git fetch*)",
+      "Bash(git pull --ff-only*)",
+      "Bash(mkdir *)",
+      "Bash(touch *)",
+      "Bash(ls *)",
+      "Bash(find *)",
+      "Bash(grep *)",
+      "Bash(rg *)",
+      "Bash(cat *)",
+      "Bash(head *)",
+      "Bash(tail *)",
+      "Bash(wc *)",
+      "Bash(sort *)",
+      "Bash(uniq *)",
+      "Bash(jq *)",
+      "Bash(curl http://localhost*)",
+      "Bash(curl http://127.0.0.1*)",
+      "Bash(pnpm exec skillex*)",
+      "Bash(pnpm exec playwright *)",
+      "Bash(pnpm exec vitest*)",
+      "Bash(pnpm exec drizzle-kit*)",
+      "Bash(pnpm exec next *)",
+      "Bash(pnpm exec tsc*)",
+      "Bash(pnpm exec oxlint*)",
+      "Bash(pnpm exec oxfmt*)",
+      "Bash(pnpm exec stylelint*)",
+      "Read",
+      "Edit",
+      "Write",
+      "Glob",
+      "Grep",
+      "WebFetch"
+    ],
+    "ask": [
+      "Bash(git commit*)",
+      "Bash(git push*)",
+      "Bash(git merge*)",
+      "Bash(git rebase*)",
+      "Bash(git reset*)",
+      "Bash(gh issue*)",
+      "Bash(gh pr*)",
+      "Bash(gh release*)",
+      "Bash(gh workflow*)",
+      "Bash(pnpm publish*)",
+      "Bash(pnpm nx release*)",
+      "Bash(npm publish*)"
+    ],
+    "deny": [
+      "Bash(git push --force*)",
+      "Bash(git push -f *)",
+      "Bash(git push * --force*)",
+      "Bash(rm -rf /*)",
+      "Bash(rm -rf ~)",
+      "Bash(rm -rf $HOME*)",
+      "Bash(cat .env*)",
+      "Bash(cat *.env)",
+      "Bash(cat *.env.local)",
+      "Bash(cat *.env.production)",
+      "Bash(printenv)",
+      "Bash(env)",
+      "Read(./.env)",
+      "Read(./.env.local)",
+      "Read(./.env.production)",
+      "Read(./.env.*)",
+      "Read(./**/.env)",
+      "Read(./**/.env.local)",
+      "Read(./**/.env.production)"
+    ]
+  }
+}

package/templates/static/_github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,18 @@
+<!-- Brief description of what this PR does and why. -->
+
+## Summary
+
+-
+-
+
+## Verification
+
+- [ ] `pnpm lint` passes
+- [ ] `pnpm format:check` passes
+- [ ] `pnpm style` passes
+- [ ] `pnpm typecheck` passes
+- [ ] `pnpm build` succeeds
+
+## Notes
+
+<!-- Anything reviewers should know. -->

package/templates/static/_github/dependabot.yml

@@ -0,0 +1,43 @@
+version: 2
+
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+    groups:
+      raredays:
+        patterns:
+          - "@raredays/*"
+      react:
+        patterns:
+          - react
+          - react-dom
+          - "@types/react"
+          - "@types/react-dom"
+      next:
+        patterns:
+          - next
+      tailwind:
+        patterns:
+          - tailwindcss
+          - "@tailwindcss/*"
+      storybook:
+        patterns:
+          - storybook
+          - "@storybook/*"
+      dev-tooling:
+        dependency-type: development
+        patterns:
+          - "*"
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 3
+    groups:
+      gha:
+        patterns:
+          - "*"

package/templates/static/_github/workflows/ci.yml

@@ -0,0 +1,91 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+# Mirrors the RareDays framework's CI discipline for consumer apps.
+# Static template has no vitest test target — verification chain is
+# lint / format / style / typecheck / build / storybook only.
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 24, cache: pnpm }
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm lint
+
+  format-check:
+    name: Format check
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 24, cache: pnpm }
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm format:check
+
+  style:
+    name: Style
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 24, cache: pnpm }
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm style
+
+  typecheck:
+    name: Typecheck
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 24, cache: pnpm }
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm theme:build
+      - run: pnpm typecheck
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 24, cache: pnpm }
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build
+
+  storybook:
+    name: Storybook build
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    if: hashFiles('.storybook/main.ts', '.storybook/main.js') != ''
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 24, cache: pnpm }
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm theme:build
+      - run: pnpm storybook:build

package/templates/static/_gitignore

@@ -0,0 +1,15 @@
+node_modules/
+.next/
+out/
+dist/
+*.tsbuildinfo
+next-env.d.ts
+
+.env
+.env.local
+.env.*.local
+
+.skillex/
+
+.DS_Store
+*.log

package/templates/static/_npmrc

@@ -0,0 +1 @@
+@raredays:registry=http://localhost:4873

package/templates/static/app/(marketing)/layout.tsx

@@ -0,0 +1,21 @@
+import { MarketingLayout, MarketingHeader, MarketingFooter } from "@raredays/components";
+import type { ReactNode } from "react";
+
+export default function MarketingGroupLayout({ children }: { children: ReactNode }) {
+  return (
+    <MarketingLayout
+      header={
+        <MarketingHeader
+          logo={<span className="text-lg font-bold">RareDays</span>}
+          navigation={[
+            { label: "Features", href: "/#features" },
+            { label: "Pricing", href: "/#pricing" },
+          ]}
+        />
+      }
+      footer={<MarketingFooter copyright={`© ${new Date().getFullYear()} RareDays`} />}
+    >
+      {children}
+    </MarketingLayout>
+  );
+}

package/templates/static/app/(marketing)/page.tsx

@@ -0,0 +1,17 @@
+export default function HomePage() {
+  return (
+    <main className="p-8 font-sans">
+      <h1 className="text-3xl font-bold">RareDays</h1>
+      <p className="mt-4 text-neutral-600">
+        Edit <code>app/page.tsx</code> to get started. Tailwind utilities are backed by tokens from{" "}
+        <code>@raredays/tokens</code>.
+      </p>
+      <button
+        type="button"
+        className="mt-6 rounded-md bg-brand-primary px-4 py-2 text-white hover:bg-brand-secondary"
+      >
+        Hello
+      </button>
+    </main>
+  );
+}

package/templates/static/app/globals.css

@@ -0,0 +1,22 @@
+/* CSS @import lines must precede all other rules. If you add a remote-font
+ * import (e.g. @import url("https://rsms.me/inter/inter.css")), it MUST go
+ * BEFORE the lines below — @raredays/style inlines ~6800 lines of CSS,
+ * after which any further @import is mid-document and rejected by Lightning
+ * CSS / PostCSS / browsers per the CSS spec. */
+@import "@raredays/style";
+@import "./theme.override.css";
+
+/* Scan compiled output from @raredays/* packages so Tailwind emits
+ * the arbitrary utilities used inside their components (e.g. underline
+ * positions, data-attribute variants). The relative `@source` paths in
+ * @raredays/style/index.css don't resolve under pnpm's strict
+ * node_modules layout — each @raredays/* package gets its own
+ * .pnpm/<pkg>/node_modules/<pkg>/ directory, so style's
+ * `../components/dist` points nowhere. These directives are relative
+ * to THIS file (`app/globals.css`), which is the consumer's cwd —
+ * resolves correctly.
+ *
+ * Add `@source "../node_modules/@raredays/<pkg>/dist"` for any
+ * additional @raredays/* package whose component utilities you use. */
+@source "../node_modules/@raredays/components/dist";
+@source "../node_modules/@raredays/core/dist";

package/templates/static/app/layout.tsx

@@ -0,0 +1,24 @@
+import { RaredaysProvider } from "@raredays/core";
+import type { Metadata, Viewport } from "next";
+import type { ReactNode } from "react";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "RareDays App",
+  description: "A RareDays Next.js application.",
+};
+
+export const viewport: Viewport = {
+  width: "device-width",
+  initialScale: 1,
+};
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        <RaredaysProvider>{children}</RaredaysProvider>
+      </body>
+    </html>
+  );
+}

package/templates/static/app/theme.override.css

@@ -0,0 +1,9 @@
+/*
+ * Auto-generated by @raredays/theme-build. Do not edit by hand.
+ * Source: site.spec.ts
+ * To regenerate: pnpm theme:build
+ */
+
+@theme {
+  /* No spec overrides — defaults from @raredays/tokens apply. */
+}

package/templates/static/next.config.ts

@@ -0,0 +1,19 @@
+import { withRaredays } from "@raredays/core";
+import type { NextConfig } from "next";
+
+// `output: "export"` produces a truly static build — plain HTML/CSS/JS in
+// `out/`, deployable to any CDN (Cloudflare Pages, R2, S3+CloudFront,
+// GitHub Pages, edge workers). No Node runtime, no `next start`.
+//
+// Trade-offs that come with this:
+//  - no SSR, no `cookies()`/`headers()`, no `revalidatePath`/`revalidateTag`
+//  - no `app/api/` route handlers
+//  - dynamic routes need `generateStaticParams`
+//
+// If you need any of the above, scaffold with `--template client` (BFF + SPA)
+// or `--template full-stack` (Next.js + framework modules).
+const config: NextConfig = withRaredays({
+  output: "export",
+});
+
+export default config;

package/templates/static/oxfmt.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig, mergeConfig, base } from "@raredays/lint/oxfmt";
+
+// Explicit return-type annotation avoids TS2742 ("inferred type cannot be
+// named without a reference to ..."). `defineConfig` is re-exported from the
+// upstream `oxfmt` package, so the inferred default-export type would
+// otherwise reference a non-portable path.
+const config: ReturnType<typeof defineConfig> = defineConfig(mergeConfig(base));
+export default config;

package/templates/static/oxlint.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig, mergeConfig, base } from "@raredays/lint/oxlint";
+
+// Explicit return-type annotation avoids TS2742 ("inferred type cannot be
+// named without a reference to ..."). `defineConfig` is re-exported from the
+// upstream `oxlint` package, so the inferred default-export type would
+// otherwise reference a non-portable path.
+const config: ReturnType<typeof defineConfig> = defineConfig(mergeConfig(base));
+export default config;

package/templates/static/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "raredays-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "postinstall": "skillex refresh -q || true",
+    "dev": "pnpm theme:build && next dev -p ${PORT:-3000}",
+    "build": "pnpm theme:build && next build",
+    "start": "serve out -l ${PORT:-3000}",
+    "theme:build": "node ./scripts/build-theme.mjs",
+    "storybook": "storybook dev -p 6006",
+    "storybook:build": "storybook build -o storybook-static",
+    "lint": "raredays lint",
+    "lint:fix": "raredays lint:fix",
+    "format": "raredays format",
+    "format:check": "raredays format:check",
+    "style": "raredays style",
+    "style:fix": "raredays style:fix",
+    "fix": "raredays fix",
+    "typecheck": "tsc --noEmit",
+    "check": "raredays check && tsc --noEmit"
+  },
+  "dependencies": {
+    "@raredays/components": "0.0.1",
+    "@raredays/core": "0.0.1",
+    "@raredays/style": "0.0.1",
+    "next": "16.2.4",
+    "react": "19.2.5",
+    "react-dom": "19.2.5"
+  },
+  "devDependencies": {
+    "@raredays/lint": "0.0.1",
+    "@raredays/site-config": "0.0.1",
+    "@raredays/theme-build": "0.0.1",
+    "@raredays/typescript": "0.0.1",
+    "@storybook/react-vite": "10.3.6",
+    "@tailwindcss/postcss": "4.2.4",
+    "@tailwindcss/vite": "4.2.4",
+    "@types/node": "22.19.17",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "@vitejs/plugin-react": "6.0.1",
+    "serve": "14.2.5",
+    "storybook": "10.3.6",
+    "tailwindcss": "4.2.4",
+    "typescript": "5.9.3",
+    "vite": "8.0.10"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}

package/templates/static/postcss.config.mjs

@@ -0,0 +1 @@
+export { default } from "@raredays/style/postcss";

package/templates/static/scripts/build-theme.mjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadSiteSpec } from "@raredays/site-config";
+import { writeThemeOverride } from "@raredays/theme-build";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const projectRoot = resolve(__dirname, "..");
+
+const spec = await loadSiteSpec(resolve(projectRoot, "site.spec.ts"));
+const outPath = resolve(projectRoot, "app/theme.override.css");
+
+await writeThemeOverride(spec, outPath, {
+  regenCommand: "pnpm theme:build",
+  source: "site.spec.ts",
+});
+
+console.log(`✓ wrote ${outPath}`);