create-raredays-app 0.1.0

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "create-raredays-app",
+  "version": "0.1.0",
+  "description": "Scaffold a new RareDays Next.js app.",
+  "license": "UNLICENSED",
+  "author": "Jeremy Harper <jeremy@raredays.com>",
+  "bin": {
+    "create-raredays-app": "./bin/index.js"
+  },
+  "files": [
+    "bin",
+    "templates",
+    "scaffold-fragments",
+    "skillex"
+  ],
+  "type": "module",
+  "dependencies": {
+    "@clack/prompts": "1.4.0"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "vitest": "4.1.5",
+    "@raredays/lint": "0.0.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "skillex": true,
+  "scripts": {
+    "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",
+    "check": "raredays check",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "dev": "mkdir -p .sandbox && cd .sandbox && node ../bin/index.js",
+    "clean": "rm -rf .sandbox"
+  }
+}

package/scaffold-fragments/billing/files/app/api/billing/webhook/route.ts

@@ -0,0 +1,5 @@
+import { webhookHandler } from "@/lib/runtime";
+
+export async function POST(req: Request): Promise<Response> {
+  return webhookHandler.handle(req);
+}

package/scaffold-fragments/billing/module.json

@@ -0,0 +1,31 @@
+{
+  "key": "billing",
+  "label": "Billing (subscriptions + webhooks)",
+  "description": "Plan registry, subscription state, webhook handler with idempotency + event-bus fan-out.",
+  "deps": {
+    "@raredays/billing": "0.0.1"
+  },
+  "vendors": [
+    {
+      "key": "stripe",
+      "label": "Stripe",
+      "deps": {
+        "@raredays/billing-stripe": "0.0.1"
+      },
+      "env": [
+        "STRIPE_SECRET_KEY",
+        "STRIPE_WEBHOOK_SECRET"
+      ],
+      "mocks": {
+        "package": "@raredays/billing-stripe/mocks",
+        "named": "stripeMocks",
+        "peerDeps": {
+          "@faker-js/faker": "10.4.0"
+        }
+      }
+    }
+  ],
+  "templates": [
+    "full-stack"
+  ]
+}

package/scaffold-fragments/billing/runtime/config.ts

@@ -0,0 +1,8 @@
+export const plans = createPlanRegistry([
+  { key: "free", displayName: "Free", rank: 0, features: ["content.read"] },
+  { key: "pro", displayName: "Pro", rank: 10, features: ["content.read", "content.download"] },
+]);
+
+const billingProvider = createInMemoryBillingProvider();
+const webhookDeliveryStore = createInMemoryWebhookDeliveryStore();
+const eventBus = createInMemoryEventBus();

package/scaffold-fragments/billing/runtime/exports.ts

@@ -0,0 +1,6 @@
+export const webhookHandler = createWebhookHandler({
+  provider: app.require("billingProvider"),
+  deliveryStore: app.require("webhookDeliveryStore"),
+  eventBus: app.require("eventBus"),
+  signatureHeader: "stripe-signature",
+});

package/scaffold-fragments/billing/runtime/imports.ts

@@ -0,0 +1,6 @@
+import { createInMemoryEventBus } from "@raredays/core";
+import { createPlanRegistry, createWebhookHandler } from "@raredays/billing";
+import {
+  createInMemoryBillingProvider,
+  createInMemoryWebhookDeliveryStore,
+} from "@raredays/billing/testing";

package/scaffold-fragments/billing/runtime/ports.ts

@@ -0,0 +1,3 @@
+  billingProvider,
+  webhookDeliveryStore,
+  eventBus,

package/scaffold-fragments/cms/module.json

@@ -0,0 +1,29 @@
+{
+  "key": "cms",
+  "label": "CMS (headless content + rich text)",
+  "description": "Vendor-neutral CMS port. In-memory dev driver for development; swap to Hygraph (or another adapter) for production.",
+  "deps": {
+    "@raredays/cms": "0.0.1"
+  },
+  "vendors": [
+    {
+      "key": "hygraph",
+      "label": "Hygraph",
+      "deps": {
+        "@raredays/cms-hygraph": "0.0.1"
+      },
+      "env": [
+        "HYGRAPH_ENDPOINT",
+        "HYGRAPH_TOKEN"
+      ],
+      "mocks": {
+        "package": "@raredays/cms-hygraph/mocks",
+        "named": "hygraphMocks"
+      }
+    }
+  ],
+  "templates": [
+    "full-stack",
+    "client"
+  ]
+}

package/scaffold-fragments/cms/runtime/config.ts

@@ -0,0 +1,4 @@
+// In-memory CMS provider for development. For production, swap to a vendor
+// adapter (e.g. createHygraphCmsProvider from @raredays/cms-hygraph) reading
+// HYGRAPH_ENDPOINT + HYGRAPH_TOKEN from env.
+const cmsProvider = createInMemoryCmsProvider();

package/scaffold-fragments/cms/runtime/exports.ts

@@ -0,0 +1 @@
+export { cmsProvider };

package/scaffold-fragments/cms/runtime/imports.ts

@@ -0,0 +1 @@
+import { createInMemoryCmsProvider } from "@raredays/cms/testing";

package/scaffold-fragments/email/module.json

@@ -0,0 +1,30 @@
+{
+  "key": "email",
+  "label": "Transactional email",
+  "description": "Vendor-neutral email port. Console adapter for dev; swap to Resend for production.",
+  "deps": {
+    "@raredays/email": "0.0.1"
+  },
+  "vendors": [
+    {
+      "key": "resend",
+      "label": "Resend",
+      "deps": {
+        "@raredays/email-resend": "0.0.1"
+      },
+      "env": [
+        "RESEND_API_KEY"
+      ],
+      "mocks": {
+        "package": "@raredays/email-resend/mocks",
+        "named": "resendMocks",
+        "peerDeps": {
+          "@faker-js/faker": "10.4.0"
+        }
+      }
+    }
+  ],
+  "templates": [
+    "full-stack"
+  ]
+}

package/scaffold-fragments/email/runtime/config.ts

@@ -0,0 +1 @@
+const emailProvider = createConsoleEmailProvider();

package/scaffold-fragments/email/runtime/imports.ts

@@ -0,0 +1 @@
+import { createConsoleEmailProvider } from "@raredays/email/testing";

package/scaffold-fragments/email/runtime/ports.ts

@@ -0,0 +1 @@
+  emailProvider,

package/scaffold-fragments/feature-flags/files/app/lib/flags.ts

@@ -0,0 +1,48 @@
+// Feature flag definitions. The framework uses Vercel's `flags` SDK
+// (https://flags-sdk.dev) — declarative `flag({ key, decide })` contracts
+// that work with any provider, or none at all.
+//
+// If you selected a vendor during scaffolding, its adapter package is
+// already in your deps. Uncomment + wire the matching block below:
+//
+//   LaunchDarkly:
+//     import { ldAdapter } from "@flags-sdk/launchdarkly";
+//     export const showNewCheckout = flag<boolean>({
+//       key: "show-new-checkout",
+//       adapter: ldAdapter.variation(),
+//       defaultValue: false,
+//     });
+//
+//   Statsig:
+//     import { statsigAdapter } from "@flags-sdk/statsig";
+//     export const showNewCheckout = flag<boolean>({
+//       key: "show_new_checkout",
+//       adapter: statsigAdapter.featureGate((gate) => gate.value),
+//       defaultValue: false,
+//     });
+//
+//   GrowthBook:
+//     import { growthbookAdapter } from "@flags-sdk/growthbook";
+//     export const showNewCheckout = flag<boolean>({
+//       key: "show-new-checkout",
+//       adapter: growthbookAdapter.feature(),
+//       defaultValue: false,
+//     });
+//
+//   Hypertune / PostHog: see https://flags-sdk.dev/docs/providers/
+//
+// Until a vendor is wired, in-process `decide()` functions are fine — the
+// SDK deduplicates evaluations per-request automatically.
+
+import { flag } from "flags/next";
+
+/**
+ * Example flag. Replace with your real ones; delete if you don't want a
+ * sample. Use in server components / route handlers as:
+ *   const enabled = await exampleFlag();
+ */
+export const exampleFlag = flag<boolean>({
+  key: "example",
+  defaultValue: false,
+  decide: () => false,
+});

package/scaffold-fragments/feature-flags/module.json

@@ -0,0 +1,66 @@
+{
+  "key": "feature-flags",
+  "label": "Feature flags (Vercel Flags SDK)",
+  "description": "Declarative flag definitions via the `flags` SDK. Provider-agnostic with official adapters for LaunchDarkly, GrowthBook, Statsig, Hypertune, PostHog, Edge Config, Flagsmith, OpenFeature.",
+  "deps": {
+    "flags": "4.0.6"
+  },
+  "vendors": [
+    {
+      "key": "launchdarkly",
+      "label": "LaunchDarkly",
+      "deps": {
+        "@flags-sdk/launchdarkly": "0.3.4"
+      },
+      "env": [
+        "LAUNCHDARKLY_CLIENT_SIDE_ID",
+        "LAUNCHDARKLY_PROJECT_SLUG",
+        "EDGE_CONFIG"
+      ]
+    },
+    {
+      "key": "statsig",
+      "label": "Statsig",
+      "deps": {
+        "@flags-sdk/statsig": "0.2.5"
+      },
+      "env": [
+        "STATSIG_SERVER_API_KEY"
+      ]
+    },
+    {
+      "key": "growthbook",
+      "label": "GrowthBook",
+      "deps": {
+        "@flags-sdk/growthbook": "0.2.0"
+      },
+      "env": [
+        "GROWTHBOOK_CLIENT_KEY"
+      ]
+    },
+    {
+      "key": "hypertune",
+      "label": "Hypertune",
+      "deps": {
+        "@flags-sdk/hypertune": "0.3.2"
+      },
+      "env": [
+        "NEXT_PUBLIC_HYPERTUNE_TOKEN",
+        "HYPERTUNE_FRAMEWORK",
+        "HYPERTUNE_OUTPUT_DIRECTORY_PATH"
+      ]
+    },
+    {
+      "key": "posthog",
+      "label": "PostHog",
+      "deps": {
+        "@flags-sdk/posthog": "0.2.2"
+      },
+      "env": [
+        "NEXT_PUBLIC_POSTHOG_KEY",
+        "NEXT_PUBLIC_POSTHOG_HOST"
+      ]
+    }
+  ],
+  "templates": ["full-stack", "client"]
+}

package/scaffold-fragments/i18n/files/messages/en-US.json

@@ -0,0 +1,15 @@
+{
+  "greeting": "Welcome to {name}",
+  "nav": {
+    "home": "Home",
+    "features": "Features",
+    "pricing": "Pricing"
+  },
+  "cta": {
+    "getStarted": "Get started",
+    "learnMore": "Learn more"
+  },
+  "footer": {
+    "copyright": "© {year} {name}. All rights reserved."
+  }
+}

package/scaffold-fragments/i18n/module.json

@@ -0,0 +1,9 @@
+{
+  "key": "i18n",
+  "label": "Internationalisation (i18n)",
+  "description": "Locale resolution, ICU message formatting, date/number/currency formatters, and React hooks.",
+  "deps": {
+    "@raredays/i18n": "0.0.1"
+  },
+  "templates": ["full-stack", "client", "static"]
+}

package/scaffold-fragments/i18n/runtime/config.ts

@@ -0,0 +1,7 @@
+const i18nConfig = defineI18nConfig({
+  defaultLocale: siteSpec.identity.locales[0]!,
+  locales: siteSpec.identity.locales.map((code) => ({ code, label: code })),
+  messages: { "en-US": enMessages },
+});
+
+const i18nIntl = createIntlInstance({ config: i18nConfig, locale: i18nConfig.defaultLocale });

package/scaffold-fragments/i18n/runtime/exports.ts

@@ -0,0 +1 @@
+export { i18nConfig, i18nIntl };

package/scaffold-fragments/i18n/runtime/imports.ts

@@ -0,0 +1,2 @@
+import { defineI18nConfig, createIntlInstance, resolveLocaleFromRequest } from "@raredays/i18n";
+import enMessages from "@/messages/en-US.json";

package/scaffold-fragments/i18n/runtime/ports.ts

@@ -0,0 +1 @@
+  intl: i18nIntl,

package/scaffold-fragments/identity/module.json

@@ -0,0 +1,30 @@
+{
+  "key": "identity",
+  "label": "Identity (auth, sessions, organizations, roles)",
+  "description": "Identity port is always wired with an in-memory dev provider. Select a vendor to add the production adapter, env vars, mock handlers, and Next.js auth route stub.",
+  "deps": {
+    "@raredays/identity": "0.0.1"
+  },
+  "vendors": [
+    {
+      "key": "better-auth",
+      "label": "Better Auth (self-hosted)",
+      "deps": {
+        "@raredays/identity-better-auth": "0.0.1",
+        "better-auth": "^1.2.0"
+      },
+      "env": [
+        "BETTER_AUTH_SECRET",
+        "BETTER_AUTH_URL"
+      ],
+      "mocks": {
+        "package": "@raredays/identity-better-auth/mocks",
+        "named": "betterAuthMocks"
+      }
+    }
+  ],
+  "templates": [
+    "full-stack",
+    "client"
+  ]
+}

package/scaffold-fragments/identity/vendors/better-auth/files/app/api/auth/[...all]/route.ts

@@ -0,0 +1,15 @@
+// Better Auth handler mount. Configure your Better Auth instance in
+// `app/lib/auth.ts` (create the file alongside this one), then `toNextJsHandler`
+// adapts it into Next.js App Router GET/POST handlers.
+//
+// Steps to finish wiring (see @raredays/identity-better-auth README):
+//   1. Create `app/lib/auth.ts` — instantiate `betterAuth({ database, ... })`
+//      against your Drizzle client.
+//   2. Replace the in-memory provider in `app/lib/runtime.ts` with
+//      `createBetterAuthProvider({ auth })` from `@raredays/identity-better-auth`.
+//   3. Fill `BETTER_AUTH_SECRET` + `BETTER_AUTH_URL` in `.env.local`.
+
+import { toNextJsHandler } from "@raredays/identity-better-auth";
+import { auth } from "@/lib/auth";
+
+export const { GET, POST } = toNextJsHandler(auth);

package/scaffold-fragments/identity/vendors/better-auth/files/app/lib/auth.ts

@@ -0,0 +1,20 @@
+// Better Auth instance used by `app/api/auth/[...all]/route.ts` and by
+// `app/lib/runtime.ts` (via `createBetterAuthProvider({ auth })` from
+// `@raredays/identity-better-auth`).
+//
+// SCAFFOLD STUB — this configuration compiles and lets the app boot, but
+// the in-memory adapter resets on every restart. To finish wiring for
+// production:
+//
+//   1. Install a Better Auth database adapter (e.g. Drizzle):
+//        pnpm add better-auth/adapters/drizzle
+//   2. Pass `database: { adapter: ..., schema: ... }` to `betterAuth({...})`.
+//   3. Set BETTER_AUTH_SECRET + BETTER_AUTH_URL in `.env.local`.
+//
+// See @raredays/identity-better-auth README for the full pattern.
+
+import { betterAuth } from "better-auth";
+
+export const auth = betterAuth({
+  emailAndPassword: { enabled: true },
+});

package/scaffold-fragments/jobs/module.json

@@ -0,0 +1,12 @@
+{
+  "key": "jobs",
+  "label": "Background jobs (in-process runner)",
+  "description": "Type-safe job definitions, retries, idempotency. In-process runner by default; swap to Inngest/Trigger.dev for durable execution.",
+  "deps": {
+    "@raredays/jobs": "0.0.1"
+  },
+  "vendors": [],
+  "templates": [
+    "full-stack"
+  ]
+}

package/scaffold-fragments/jobs/runtime/config.ts

@@ -0,0 +1,4 @@
+// Define your jobs here, then pass them into createInProcJobs:
+//   import { defineJob } from "@raredays/jobs";
+//   const myJob = defineJob({ name: "demo", handler: async () => { ... } });
+const jobs = createInProcJobs({ jobs: [], mode: "async" });

package/scaffold-fragments/jobs/runtime/imports.ts

@@ -0,0 +1 @@
+import { createInProcJobs } from "@raredays/jobs/testing";

package/scaffold-fragments/jobs/runtime/ports.ts

@@ -0,0 +1 @@
+  jobs,

package/scaffold-fragments/notifications/module.json

@@ -0,0 +1,12 @@
+{
+  "key": "notifications",
+  "label": "Notifications (multi-channel send)",
+  "description": "Notification definitions, channels (email + in-app), user preferences, dedupe, delivery logging.",
+  "deps": {
+    "@raredays/notifications": "0.0.1"
+  },
+  "vendors": [],
+  "templates": [
+    "full-stack"
+  ]
+}

package/scaffold-fragments/notifications/runtime/config.ts

@@ -0,0 +1,8 @@
+// Define notification types via defineNotification and pass them into the registry:
+//   import { defineNotification } from "@raredays/notifications";
+//   const welcomeNotification = defineNotification({ type: "account.welcome", ... });
+const notifications = createNotifications({
+  registry: createNotificationRegistry([]),
+  channels: [createInMemoryChannel("email"), createInMemoryChannel("in-app")],
+  deliveryLogger: createInMemoryDeliveryLogger(),
+});

package/scaffold-fragments/notifications/runtime/imports.ts

@@ -0,0 +1,5 @@
+import { createNotificationRegistry, createNotifications } from "@raredays/notifications";
+import {
+  createInMemoryChannel,
+  createInMemoryDeliveryLogger,
+} from "@raredays/notifications/testing";

package/scaffold-fragments/notifications/runtime/ports.ts

@@ -0,0 +1 @@
+  notifications,

package/scaffold-fragments/organizations/module.json

@@ -0,0 +1,12 @@
+{
+  "key": "organizations",
+  "label": "Organizations (multi-tenancy)",
+  "description": "Domain types + role-based permissions for organizations, memberships, and invitations. Pairs with a postgres provider for storage.",
+  "deps": {
+    "@raredays/organizations": "0.0.1"
+  },
+  "vendors": [],
+  "templates": [
+    "full-stack"
+  ]
+}

package/scaffold-fragments/telemetry/module.json

@@ -0,0 +1,43 @@
+{
+  "key": "telemetry",
+  "label": "Telemetry (logging, errors, metrics, events)",
+  "description": "Vendor-neutral observability port. Console adapters for dev; swap to Sentry + Axiom for production.",
+  "deps": {
+    "@raredays/telemetry": "0.0.1"
+  },
+  "vendors": [
+    {
+      "key": "sentry",
+      "label": "Sentry (error reporting)",
+      "deps": {
+        "@raredays/telemetry-sentry": "0.0.1"
+      },
+      "env": [
+        "SENTRY_DSN"
+      ],
+      "mocks": {
+        "package": "@raredays/telemetry-sentry/mocks",
+        "named": "sentryMocks"
+      }
+    },
+    {
+      "key": "axiom",
+      "label": "Axiom (logging)",
+      "deps": {
+        "@raredays/telemetry-axiom": "0.0.1"
+      },
+      "env": [
+        "AXIOM_TOKEN",
+        "AXIOM_DATASET"
+      ],
+      "mocks": {
+        "package": "@raredays/telemetry-axiom/mocks",
+        "named": "axiomMocks"
+      }
+    }
+  ],
+  "templates": [
+    "full-stack",
+    "client"
+  ]
+}

package/scaffold-fragments/telemetry/runtime/config.ts

@@ -0,0 +1,7 @@
+const logger = createConsoleLogger();
+const telemetry = createTelemetry({
+  logger,
+  errorReporter: createConsoleErrorReporter(logger),
+  metrics: createNoopMetrics(),
+  events: createConsoleEvents(logger),
+});

package/scaffold-fragments/telemetry/runtime/imports.ts

@@ -0,0 +1,7 @@
+import {
+  createConsoleErrorReporter,
+  createConsoleEvents,
+  createConsoleLogger,
+  createNoopMetrics,
+  createTelemetry,
+} from "@raredays/telemetry";

package/scaffold-fragments/telemetry/runtime/ports.ts

@@ -0,0 +1 @@
+  telemetry,