create-raredays-app 0.1.0

package/templates/static/site.spec.ts

@@ -0,0 +1,58 @@
+import { defineSiteSpec } from "@raredays/site-config";
+
+/**
+ * The site specification for this app.
+ *
+ * Edit this file to brand your site, configure navigation, declare integrations,
+ * and enable modules. The Tailwind theme override stylesheet at
+ * `app/theme.override.css` is regenerated from this file by `pnpm theme:build`
+ * (which is chained into `pnpm dev` and `pnpm build`).
+ */
+export default defineSiteSpec({
+  framework: "0.x",
+  runtime: "static",
+  identity: {
+    name: "__SLUG__",
+    slug: "__SLUG__",
+    canonicalDomain: "example.com",
+    locales: ["en-US"],
+  },
+  branding: {
+    // Token overrides flow into Tailwind's @theme layer at build time.
+    // Anything in @raredays/tokens can be overridden here; unset keys keep
+    // the framework defaults. Examples:
+    //
+    // tokens: {
+    //   color: { brand: { primary: "#0070f3", secondary: "#111111" } },
+    //   font: { sans: "'Inter Variable', ui-sans-serif, system-ui, sans-serif" },
+    //   radius: { md: "0.5rem" },
+    // },
+    assets: {
+      logo: "/logo.svg",
+      favicon: "/favicon.ico",
+    },
+  },
+  navigation: {
+    primary: [{ label: "Home", href: "/" }],
+    footer: [{ label: "About", href: "/about" }],
+  },
+  // Module configurations live here, keyed by module id. Each enabled module
+  // package validates its own slice. Example:
+  //
+  // modules: {
+  //   billing: { plans: [...] },
+  // },
+  integrations: {
+    // Each integration's credential slots reference SHOUTING_SNAKE_CASE env
+    // var names — never literal secret values. Example:
+    //
+    // stripe: {
+    //   secretKey: "STRIPE_SECRET_KEY",
+    //   webhookSecret: "STRIPE_WEBHOOK_SECRET",
+    // },
+  },
+  deploy: {
+    vercel: { projectId: "prj_replace_me" },
+    // No `database` field — static apps have no server runtime.
+  },
+});

package/templates/static/skillex.json

@@ -0,0 +1,12 @@
+{
+  "Version": 4,
+  "Rules": [
+    {
+      "Scope": "**",
+      "Skills": [
+        "skills/repo.md"
+      ],
+      "DependencyBoundary": "."
+    }
+  ]
+}

package/templates/static/skills/repo.md

@@ -0,0 +1,56 @@
+---
+title: Repository conventions
+topic: repo-conventions
+tags: [getting-started]
+---
+
+# Repository conventions
+
+This app was scaffolded with `create-raredays-app`. The framework's
+`@raredays/*` packages are workspace deps and ship their own skills, all
+auto-discovered via the `DependencyBoundary` in `skillex.json`.
+
+## Layout
+
+```
+app/
+├── (auth)/         # Sign-in / sign-up routes (when identity:better-auth is wired)
+├── (subscribed)/   # Routes gated behind an active subscription
+├── api/            # API route handlers
+├── demo/           # Sample pages (delete or replace)
+├── lib/
+│   └── runtime.ts  # Provider composition root — edit here to swap providers
+├── globals.css     # Tailwind v4 entry; scans @raredays/* dists for utilities
+├── layout.tsx      # Root layout — wraps app in RaredaysProvider
+└── theme.override.css  # Generated by `pnpm theme:build` from site.spec.ts
+db/                 # Drizzle schema + migrations
+mocks/              # MSW handlers (node + browser setups)
+public/             # Static assets + mockServiceWorker.js
+site.spec.ts        # Single source of truth for site config — feeds theme:build
+```
+
+## Always-on workflow
+
+```sh
+pnpm install           # auto-runs skillex refresh via postinstall
+pnpm dev               # Next dev server
+pnpm dev:mocks         # Dev with MSW intercepting fetch
+pnpm test              # vitest run (node-mode tests)
+pnpm check             # lint + format:check + style + typecheck (gate before commit)
+```
+
+## Where things live in the framework
+
+- `@raredays/core` — provider/port pattern, `RaredaysProvider`, env-config, ports
+- `@raredays/components` — design system components (Tailwind v4, shadcn-flavored)
+- `@raredays/identity` (+ `identity-better-auth`) — auth, sessions, organizations
+- `@raredays/billing` (+ `billing-stripe`) — subscriptions, webhooks → events
+- `@raredays/notifications` — in-app + email notification port
+- `@raredays/cms` (+ `cms-hygraph`, `cms-bridge`) — headless CMS port + canonical-id bridge
+- `@raredays/engagement` — declarative engagement tables (bookmarks, history, tags)
+- `@raredays/state-machine` — typed state machine primitive
+- `@raredays/i18n` — locale-aware translations + formatters
+- `@raredays/mocks` — MSW setup for node + browser
+
+Run `pnpm exec skillex query --package "@raredays/<name>"` for any of them
+to see canonical usage patterns.

package/templates/static/stylelint.config.mjs

@@ -0,0 +1,4 @@
+/** @type {import("stylelint").Config} */
+export default {
+  extends: ["@raredays/lint/stylelint"],
+};

package/templates/static/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@raredays/typescript/tsconfig.next.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./app/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}