@pylonsync/create-pylon 0.8.1 → 0.8.3

package/templates/saas/lib/billing.ts

@@ -1,4 +1,5 @@
 import { stripe } from "@pylonsync/stripe";
+import { TRIAL_DAYS } from "./plans";
 
 // Per-workspace (org) billing. The active org IS the billing reference: its
 // subscription decides the plan, and only owners/admins can change it (the
@@ -9,17 +10,23 @@ import { stripe } from "@pylonsync/stripe";
 //   STRIPE_SECRET_KEY       sk_test_… / sk_live_…   (required to charge)
 //   STRIPE_WEBHOOK_SECRET   whsec_…                 (required for the webhook)
 //   STRIPE_PRICE_PRO        price_…                 (the "pro" monthly price)
+//   STRIPE_PRICE_PRO_ANNUAL price_…                 (the "pro" yearly price)
 // Until STRIPE_SECRET_KEY is set the handlers return STRIPE_NOT_CONFIGURED and
 // the Billing page shows a "connect Stripe" state — the app still boots + runs.
+//
+// Prices and the trial length are shown to customers from lib/plans.ts; keep
+// the Stripe prices and that catalog in agreement.
 export const billing = stripe({
   referenceType: "org",
   plans: [
     {
       name: "pro",
       priceId: process.env.STRIPE_PRICE_PRO ?? "",
-      // App-defined entitlement limits, stored on the subscription row so
-      // quota checks don't need the plan list. Tune to whatever you meter.
-      limits: { projects: 100, seats: 25 },
+      annualPriceId: process.env.STRIPE_PRICE_PRO_ANNUAL || undefined,
+      // Card up front, no charge until the trial ends. Stripe allows one
+      // trial per customer; the plugin refuses a second.
+      freeTrial: { days: TRIAL_DAYS },
+      limits: { projects: -1, seats: -1 },
     },
   ],
 });

package/templates/saas/lib/plans.ts

@@ -0,0 +1,94 @@
+// The plan catalog. One place for prices, the free-tier cap, the trial
+// length, and the feature bullets, read by the marketing pricing page, the
+// Billing tab, the Stripe plugin config (lib/billing.ts), and the server
+// function that enforces the cap (functions/createProject.ts).
+
+/** Active projects a free workspace can have. `createProject` enforces it. */
+export const FREE_PROJECT_LIMIT = 3;
+
+/** Days of free Pro on the first subscription. Stripe collects a card up front. */
+export const TRIAL_DAYS = 14;
+
+export type PlanId = "free" | "pro";
+
+export interface PlanDefinition {
+  id: PlanId;
+  name: string;
+  tagline: string;
+  /** USD per month, billed monthly. */
+  monthly: number;
+  /** USD per month when billed annually (null = no annual price). */
+  annualPerMonth: number | null;
+  features: string[];
+  cta: string;
+}
+
+export const PLANS: PlanDefinition[] = [
+  {
+    id: "free",
+    name: "Free",
+    tagline: "For getting started.",
+    monthly: 0,
+    annualPerMonth: null,
+    features: [
+      `Up to ${FREE_PROJECT_LIMIT} active projects`,
+      "Unlimited members",
+      "Real-time collaboration",
+      "Community support",
+    ],
+    cta: "Get started",
+  },
+  {
+    id: "pro",
+    name: "Pro",
+    tagline: "For teams shipping every week.",
+    monthly: 29,
+    annualPerMonth: 24,
+    features: [
+      "Unlimited projects",
+      "Unlimited members",
+      "Priority support",
+      "Everything we ship next",
+    ],
+    cta: `Start ${TRIAL_DAYS}-day free trial`,
+  },
+];
+
+export function planById(id: string): PlanDefinition | undefined {
+  return PLANS.find((p) => p.id === id);
+}
+
+/** "$29" / "$0". */
+export function formatPrice(usd: number): string {
+  return `$${usd}`;
+}
+
+/** Whole-year price for the annual option, e.g. 24 → 288. */
+export function annualTotal(plan: PlanDefinition): number | null {
+  return plan.annualPerMonth == null ? null : plan.annualPerMonth * 12;
+}
+
+/** Percent saved by paying annually, rounded. */
+export function annualSavingsPercent(plan: PlanDefinition): number {
+  if (plan.annualPerMonth == null || plan.monthly === 0) return 0;
+  return Math.round((1 - plan.annualPerMonth / plan.monthly) * 100);
+}
+
+/**
+ * Can a workspace on `plan` with `activeProjects` create one more?
+ * Pure so the cap is unit-tested; `createProject` calls it.
+ */
+export function canCreateProject(plan: PlanId, activeProjects: number): boolean {
+  if (plan === "pro") return true;
+  return activeProjects < FREE_PROJECT_LIMIT;
+}
+
+/** A subscription counts as Pro while Stripe reports it usable. */
+export const ACTIVE_STATUSES = ["active", "trialing", "past_due"];
+
+export function planFromSubscription(
+  sub: { plan?: string; status?: string } | null | undefined,
+): PlanId {
+  if (!sub) return "free";
+  return ACTIVE_STATUSES.includes(sub.status ?? "") && sub.plan === "pro" ? "pro" : "free";
+}

package/templates/saas/lib/site.config.ts

@@ -1,3 +1,4 @@
+import { PLANS, formatPrice } from "./plans";
 // Business-specific copy and settings live here. The marketing components,
 // `create-pylon` scaffolder, and automated generators all read this file.
 //
@@ -280,51 +281,18 @@ export const siteConfig: SiteConfig = {
   pricing: {
     eyebrow: "Pricing",
     headline: "Simple pricing. Every plan.",
-    body: "Start free and upgrade as your team grows, with predictable pricing and no annual commitment.",
-    plans: [
-      {
-        name: "Free",
-        tagline: "For getting started.",
-        price: "$0",
-        unit: "forever",
-        cta: "Get started",
-        featured: false,
-        features: [
-          "Up to 3 projects",
-          "Unlimited members",
-          "Real-time board",
-          "Community support",
-        ],
-      },
-      {
-        name: "Team",
-        tagline: "For small teams.",
-        price: "$29",
-        unit: "/ month",
-        cta: "Start free trial",
-        featured: true,
-        features: [
-          "Unlimited projects",
-          "Roadmap and updates",
-          "Private boards",
-          "Priority support",
-        ],
-      },
-      {
-        name: "Business",
-        tagline: "For growing teams.",
-        price: "$59",
-        unit: "/ month",
-        cta: "Start free trial",
-        featured: false,
-        features: [
-          "Everything in Team",
-          "SSO and audit log",
-          "Custom domain",
-          "Onboarding help",
-        ],
-      },
-    ],
+    body: "Start free. Try Pro free for two weeks, and pay yearly to save.",
+    // Derived from lib/plans.ts, the catalog the Billing tab and the server
+    // cap read, so marketing and billing can't disagree on a price.
+    plans: PLANS.map((p) => ({
+      name: p.name,
+      tagline: p.tagline,
+      price: formatPrice(p.monthly),
+      unit: p.monthly === 0 ? "forever" : "/ month",
+      cta: p.cta,
+      featured: p.id === "pro",
+      features: p.features,
+    })),
   },
 
   team: {

package/templates/saas/tests/plans.test.ts

@@ -0,0 +1,35 @@
+import { expect, test } from "bun:test";
+import {
+  FREE_PROJECT_LIMIT,
+  annualSavingsPercent,
+  annualTotal,
+  canCreateProject,
+  planById,
+  planFromSubscription,
+} from "../lib/plans";
+
+// Tier 1 (pure logic) — the cap and the plan derivation that
+// functions/createProject.ts and the dashboard rely on.
+
+test("free workspaces stop at the cap, pro never does", () => {
+  expect(canCreateProject("free", 0)).toBe(true);
+  expect(canCreateProject("free", FREE_PROJECT_LIMIT - 1)).toBe(true);
+  expect(canCreateProject("free", FREE_PROJECT_LIMIT)).toBe(false);
+  expect(canCreateProject("pro", 10_000)).toBe(true);
+});
+
+test("a subscription is pro only while Stripe reports it usable", () => {
+  expect(planFromSubscription(null)).toBe("free");
+  expect(planFromSubscription({ plan: "pro", status: "active" })).toBe("pro");
+  expect(planFromSubscription({ plan: "pro", status: "trialing" })).toBe("pro");
+  expect(planFromSubscription({ plan: "pro", status: "past_due" })).toBe("pro");
+  expect(planFromSubscription({ plan: "pro", status: "canceled" })).toBe("free");
+  expect(planFromSubscription({ plan: "enterprise", status: "active" })).toBe("free");
+});
+
+test("annual pricing derives its total and saving from the catalog", () => {
+  const pro = planById("pro")!;
+  expect(annualTotal(pro)).toBe(pro.annualPerMonth! * 12);
+  expect(annualSavingsPercent(pro)).toBeGreaterThan(0);
+  expect(annualSavingsPercent(planById("free")!)).toBe(0);
+});

package/templates/saas/app/not-found.tsx

@@ -1,44 +0,0 @@
-import React from "react";
-import { Link, type NotFoundProps } from "@pylonsync/react";
-import { Button } from "@/components/ui/button";
-
-// `app/not-found.tsx` → rendered at HTTP 404 for any unmatched URL, and when a
-// page calls `response.notFound()`.
-//
-// Give it real links. This boundary is also what an agent reads when it guesses
-// a URL wrong: a markdown request for a missing page renders THIS file as
-// markdown at 404, so the links below are how it finds its way back.
-export default function NotFound(_props: NotFoundProps) {
-  return (
-    <div className="mx-auto flex min-h-[60vh] max-w-lg flex-col justify-center gap-6 px-4">
-      <section>
-        <h1 className="text-2xl font-semibold tracking-tight">Page not found</h1>
-        <p className="mt-2 text-muted-foreground">
-          That URL does not exist. Try one of these:
-        </p>
-      </section>
-      <ul className="space-y-2 text-sm">
-        <li>
-          <Link className="underline underline-offset-4" href="/">
-            Home
-          </Link>
-        </li>
-        <li>
-          <a className="underline underline-offset-4" href="/sitemap.xml">
-            Sitemap
-          </a>
-        </li>
-        <li>
-          <a className="underline underline-offset-4" href="/llms.txt">
-            llms.txt
-          </a>
-        </li>
-      </ul>
-      <div>
-        <Button asChild>
-          <Link href="/">Back to home</Link>
-        </Button>
-      </div>
-    </div>
-  );
-}