Merge pull request #23 from willwearing/feat/landing-site-custom-domains

Premium landing page, SEO/AEO, DB-driven brands, domain provisioning

Author: willwearing

.github/workflows/ci-deploy.yml

@@ -11,7 +11,6 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  # ─── Tests ───────────────────────────────────────────
   test:
     name: Test
     runs-on: ubuntu-latest
@@ -31,15 +30,20 @@ jobs:
       - name: Generate Prisma client
         run: cd backend && bun x prisma generate
 
+      - name: Type check backend
+        run: cd backend && bun x tsc -p tsconfig.build.json --noEmit
+
+      - name: Type check frontend
+        run: cd apps/web && bun x tsc --noEmit
+
       - name: Run backend tests
         run: cd backend && bun run test
 
       - name: Run frontend tests
         run: cd apps/web && bun run test
 
-  # ─── Deploy backend to Railway (only on main) ───────
-  deploy-backend:
-    name: Deploy Backend (Railway)
+  deploy:
+    name: Deploy
     needs: test
     if: github.ref == 'refs/heads/main' && github.event_name == 'push'
     runs-on: ubuntu-latest
@@ -49,35 +53,10 @@ jobs:
       - name: Install Railway CLI
         run: npm install -g @railway/cli
 
-      - name: Deploy to Railway
+      - name: Deploy backend to Railway
         run: railway up --service ${{ vars.RAILWAY_SERVICE_NAME }}
         env:
           RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}
 
-  # ─── Deploy frontend to Vercel (only on main) ───────
-  deploy-frontend:
-    name: Deploy Frontend (Vercel)
-    needs: test
-    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: "1.3.6"
-
-      - name: Install Vercel CLI
-        run: npm install -g vercel
-
-      - name: Pull Vercel env
-        run: vercel pull --yes --environment=production --token=${{ secrets.VERCEL_TOKEN }}
-        working-directory: apps/web
-
-      - name: Build
-        run: vercel build --prod --token=${{ secrets.VERCEL_TOKEN }}
-        working-directory: apps/web
-
-      - name: Deploy
-        run: vercel deploy --prebuilt --prod --token=${{ secrets.VERCEL_TOKEN }}
-        working-directory: apps/web
+      - name: Deploy frontend to Vercel
+        run: curl -s -X POST "${{ secrets.VERCEL_DEPLOY_HOOK }}"

apps/web/src/app/(marketing)/page.tsx

@@ -5,7 +5,7 @@ import { HowItWorks } from "@/components/marketing/how-it-works";
 import { FAQ } from "@/components/marketing/faq";
 import { PricingSection } from "@/components/marketing/pricing";
 import { CTA } from "@/components/marketing/cta";
-import { CourseJsonLd, OrganizationJsonLd } from "@/components/seo/json-ld";
+import { CourseJsonLd, OrganizationJsonLd, CredentialJsonLd } from "@/components/seo/json-ld";
 
 export default async function LandingPage() {
   const brand = await resolvePageBrand();
@@ -17,11 +17,22 @@ export default async function LandingPage() {
         subheadline={brand.landing.hero.subheadline}
         ctaText={brand.landing.hero.ctaText}
       />
-      <Features features={brand.landing.features} />
-      <HowItWorks steps={brand.landing.howItWorks} />
+      <Features
+        heading={brand.landing.features.heading}
+        subheading={brand.landing.features.subheading}
+        features={brand.landing.features.items}
+      />
+      <HowItWorks
+        heading={brand.landing.howItWorks.heading}
+        steps={brand.landing.howItWorks.items}
+      />
       <PricingSection />
       <FAQ items={brand.landing.faq} />
-      <CTA ctaText={brand.landing.hero.ctaText} />
+      <CTA
+        ctaText={brand.landing.hero.ctaText}
+        headline={brand.landing.bottomCta.headline}
+        subheadline={brand.landing.bottomCta.subheadline}
+      />
       <CourseJsonLd
         name={`${brand.name} -- Audio Exam Prep`}
         description={brand.seo.description}
@@ -34,6 +45,13 @@ export default async function LandingPage() {
         description={brand.seo.description}
         logoUrl={`https://${brand.domain}${brand.logoUrl}`}
       />
+      <CredentialJsonLd
+        name={`${brand.name} Certification Prep`}
+        description={brand.seo.description}
+        url={`https://${brand.domain}`}
+        educationalLevel="Professional"
+        credentialCategory="Professional Certification"
+      />
     </div>
   );
 }

apps/web/src/app/globals.css

@@ -209,3 +209,44 @@
     min-width: 44px;
   }
 }
+
+/* ── 4th gradient orb ──────────────────────────────────────────────── */
+.gradient-mesh .orb-4 {
+  @apply absolute -bottom-1/4 -right-1/4 h-[350px] w-[350px] rounded-full opacity-25 blur-3xl;
+  background: radial-gradient(circle, color-mix(in hsl, var(--primary), transparent 50%) 0%, transparent 60%);
+  animation: float 14s ease-in-out infinite reverse;
+}
+
+/* ── Glow pulse for CTA buttons ──────────────────────────────────── */
+.glow-pulse {
+  box-shadow: 0 0 20px color-mix(in hsl, var(--primary), transparent 50%),
+              0 0 60px color-mix(in hsl, var(--primary), transparent 70%);
+  animation: glow 3s ease-in-out infinite;
+}
+
+@keyframes glow {
+  0%, 100% { box-shadow: 0 0 20px color-mix(in hsl, var(--primary), transparent 50%), 0 0 60px color-mix(in hsl, var(--primary), transparent 70%); }
+  50% { box-shadow: 0 0 30px color-mix(in hsl, var(--primary), transparent 30%), 0 0 80px color-mix(in hsl, var(--primary), transparent 50%); }
+}
+
+/* ── Connecting line animation for How It Works ──────────────────── */
+@keyframes line-grow {
+  from { height: 0; }
+  to { height: 100%; }
+}
+
+.animate-line-grow {
+  animation: line-grow 1.5s ease-out forwards;
+}
+
+/* ── Scroll-triggered fade-in sections ───────────────────────────── */
+.fade-in-section {
+  opacity: 0;
+  transform: translateY(24px);
+  transition: opacity 0.6s ease-out, transform 0.6s ease-out;
+}
+
+.fade-in-section.is-visible {
+  opacity: 1;
+  transform: translateY(0);
+}

apps/web/src/app/layout.tsx

@@ -28,9 +28,22 @@ export async function generateMetadata(): Promise<Metadata> {
     keywords: brand.seo.keywords,
     openGraph: {
       type: "website",
+      locale: "en_US",
+      siteName: brand.name,
       title: brand.seo.title,
       description: brand.seo.description,
-      ...(brand.ogImageUrl ? { images: [{ url: brand.ogImageUrl }] } : {}),
+      ...(brand.ogImageUrl
+        ? { images: [{ url: brand.ogImageUrl, width: 1200, height: 630 }] }
+        : {}),
+    },
+    twitter: {
+      card: "summary_large_image",
+      title: brand.seo.title,
+      description: brand.seo.description,
+      ...(brand.ogImageUrl ? { images: [brand.ogImageUrl] } : {}),
+    },
+    alternates: {
+      canonical: `https://${brand.domain}`,
     },
   };
 }

apps/web/src/app/llms.txt/__tests__/route.test.ts

@@ -0,0 +1,65 @@
+import { describe, it, expect } from "vitest";
+import { generateLlmsTxt } from "../route";
+
+describe("generateLlmsTxt", () => {
+  it("returns a string containing brand name", () => {
+    const result = generateLlmsTxt({
+      name: "FirefighterPrep",
+      tagline: "Pass Your Firefighter Exam. Eyes-Free.",
+      description: "Audio-first adaptive learning for NFPA 1001.",
+      domain: "firefighterprep.audio",
+      features: ["Audio-First Learning", "Adaptive Engine"],
+    });
+    expect(result).toContain("FirefighterPrep");
+    expect(result).toContain("firefighterprep.audio");
+    expect(result).toContain("Audio-First Learning");
+  });
+
+  it("uses markdown-like formatting", () => {
+    const result = generateLlmsTxt({
+      name: "Test",
+      tagline: "Tag",
+      description: "Desc",
+      domain: "test.com",
+      features: ["F1"],
+    });
+    expect(result).toContain("# Test");
+  });
+
+  it("includes all standard links", () => {
+    const result = generateLlmsTxt({
+      name: "TestBrand",
+      tagline: "A tagline",
+      description: "A description",
+      domain: "example.com",
+      features: [],
+    });
+    expect(result).toContain("https://example.com");
+    expect(result).toContain("https://example.com/sign-up");
+    expect(result).toContain("https://example.com/pricing");
+  });
+
+  it("formats features as bullet points", () => {
+    const result = generateLlmsTxt({
+      name: "Brand",
+      tagline: "Tag",
+      description: "Desc",
+      domain: "brand.com",
+      features: ["Feature A", "Feature B", "Feature C"],
+    });
+    expect(result).toContain("- Feature A");
+    expect(result).toContain("- Feature B");
+    expect(result).toContain("- Feature C");
+  });
+
+  it("includes blockquote tagline", () => {
+    const result = generateLlmsTxt({
+      name: "Brand",
+      tagline: "The best tagline ever",
+      description: "Desc",
+      domain: "brand.com",
+      features: [],
+    });
+    expect(result).toContain("> The best tagline ever");
+  });
+});

apps/web/src/app/llms.txt/route.ts

@@ -0,0 +1,55 @@
+import { resolvePageBrand } from "@/lib/brand/resolve";
+
+export interface LlmsTxtInput {
+  name: string;
+  tagline: string;
+  description: string;
+  domain: string;
+  features: string[];
+}
+
+export function generateLlmsTxt(input: LlmsTxtInput): string {
+  const lines = [
+    `# ${input.name}`,
+    "",
+    `> ${input.tagline}`,
+    "",
+    input.description,
+    "",
+    `## What ${input.name} Offers`,
+    "",
+    ...input.features.map((f) => `- ${f}`),
+    "",
+    `## Links`,
+    "",
+    `- Website: https://${input.domain}`,
+    `- Sign Up: https://${input.domain}/sign-up`,
+    `- Pricing: https://${input.domain}/pricing`,
+  ];
+  return lines.join("\n");
+}
+
+export async function GET() {
+  const brand = await resolvePageBrand();
+
+  // Handle both shapes: { heading, subheading, items } (current) or raw array (legacy)
+  const featureItems = brand.landing.features.items || brand.landing.features;
+  const features = Array.isArray(featureItems)
+    ? featureItems.map((f: any) => `${f.title}: ${f.description}`)
+    : [];
+
+  const content = generateLlmsTxt({
+    name: brand.name,
+    tagline: brand.tagline,
+    description: brand.seo.description,
+    domain: brand.domain,
+    features,
+  });
+
+  return new Response(content, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Cache-Control": "public, max-age=86400",
+    },
+  });
+}

apps/web/src/app/robots.ts

@@ -7,31 +7,27 @@ async function getBaseUrl(): Promise<string> {
     const headersList = await headers();
     const hostname = headersList.get("host") || "";
     if (hostname && hostname !== "localhost") {
-      const brand = await resolveBrand(hostname);
+      const cookieHeader = headersList.get("cookie");
+      const brand = await resolveBrand(hostname, cookieHeader);
       return `https://${brand.domain}`;
     }
   } catch {
-    // static export or build time — fall back to env
+    // static export or build time
   }
-  return process.env.NEXT_PUBLIC_SITE_URL || "https://electricianprep.audio";
+  return process.env.NEXT_PUBLIC_SITE_URL || "https://firefighterprep.audio";
 }
 
 export default async function robots(): Promise<MetadataRoute.Robots> {
   const BASE_URL = await getBaseUrl();
   return {
     rules: [
-      {
-        userAgent: "*",
-        allow: "/",
-        disallow: [
-          "/dashboard",
-          "/study",
-          "/browse",
-          "/settings",
-          "/diagnostic",
-          "/auth",
-        ],
-      },
+      { userAgent: "*", allow: "/", disallow: ["/dashboard", "/study", "/browse", "/settings", "/diagnostic", "/auth"] },
+      { userAgent: "ChatGPT-User", allow: "/" },
+      { userAgent: "Applebot", allow: "/" },
+      { userAgent: "GPTBot", disallow: "/" },
+      { userAgent: "Google-Extended", disallow: "/" },
+      { userAgent: "CCBot", disallow: "/" },
+      { userAgent: "anthropic-ai", disallow: "/" },
     ],
     sitemap: `${BASE_URL}/sitemap.xml`,
   };

apps/web/src/components/marketing/__tests__/cta.test.tsx

@@ -0,0 +1,29 @@
+import { describe, it, expect } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { CTA } from "../cta";
+
+describe("CTA", () => {
+  it("renders headline and subheadline from props", () => {
+    render(
+      <CTA ctaText="Start Now" headline="Ready?" subheadline="Join thousands." />,
+    );
+    expect(screen.getByText("Ready?")).toBeTruthy();
+    expect(screen.getByText("Join thousands.")).toBeTruthy();
+  });
+
+  it("renders CTA button with correct text", () => {
+    render(
+      <CTA ctaText="Get Started" headline="Go" subheadline="Sub" />,
+    );
+    const link = screen.getByRole("link", { name: /get started/i });
+    expect(link).toBeTruthy();
+    expect(link.getAttribute("href")).toBe("/sign-up");
+  });
+
+  it("renders free-to-start subtext", () => {
+    render(
+      <CTA ctaText="Go" headline="H" subheadline="S" />,
+    );
+    expect(screen.getByText(/free to start/i)).toBeTruthy();
+  });
+});