DigitalAssetIdeas
Project Blueprint

1 Project Overview

What we're building and why.

Target Audience

• Lead gen entrepreneurs — people building rank-and-rent or per-lead businesses in home improvement
• Digital product builders — people selling funnel templates, ad scripts, landing pages
• Home improvement contractors — HVAC, roofing, solar companies looking for marketing ideas

Revenue Model

2 IdeaBrowser Research

What we learned from studying the competition.

How IdeaBrowser Works

The Three States of an Idea Page

IdeaBrowser's Pricing

Key Design Details

• Colors: White bg, deep purple-blue primary, orange/red for urgency, green for CTAs
• Typography: Serif for report headlines (editorial feel), sans-serif for body/UI
• Thumbnails: Mini dashboard previews with trend lines, KPI pills, colored gradients
• Locked cards: Blurred content + frosted glass "Members Only" overlay
• Auth: Magic link (email) + Google OAuth — no passwords

What Makes It Work

1. Scarcity is real — content actually disappears, not a fake countdown
2. FOMO drives daily visits — "come back tomorrow or miss it forever"
3. Email capture is frictionless — just email, get today's idea instantly
4. The teaser on the locked page shows enough to want it, not enough to use it
5. The archive is the real product — 1,000+ ideas is what you pay for

3 The 24-Hour Model

How the free → locked → paid flow works.

4 Tech Stack

Why we chose each piece.

5 Architecture

How the pieces connect.

6 Database Schema

Three tables in Convex.

{
  title: string,           // "ADU permit lead gen for homeowners..."
  slug: string,            // "adu-permit-lead-gen-homeowners"
  description: string,     // Short preview (2-3 sentences)
  fullReport: string,      // Full markdown (LOCKED content)
  publishedAt: number,     // Unix timestamp ms
  expiresAt: number,       // publishedAt + 24h
  isIdeaOfTheDay: boolean, // true for today's idea only
  status: string,          // "live" | "expired" | "draft"
  niche: string,           // "hvac", "roofing", "solar", "adu"
  tags: string[],          // ["high-ticket", "geo-targeted"]
  scores: {
    opportunity: number,   // 1-10
    problem: number,       // 1-10
    feasibility: number,   // 1-10
    timing: number,        // 1-10
  },
  keyword: string,         // Primary SEO keyword
  searchVolume: number,    // Monthly searches
  growthPercent: number,   // YoY growth
  revenuePotential: string,// "$" | "$$" | "$$$"
  executionDifficulty: number, // 1-10
  goToMarket: number,      // 1-10
  offer: {
    leadMagnet: { name: string, price: string },
    frontend:   { name: string, price: string },
    core:       { name: string, price: string },
  },
  createdAt: number,
  updatedAt: number,
}
// Indexes: by_published, by_slug, by_niche, by_status, by_active

{
  clerkId: string,              // Clerk user ID
  email: string,
  memberLevel: string,          // "free" | "member" | "premium"
  stripeCustomerId: optional<string>,
  subscribedAt: optional<number>,
  lastLoginAt: number,
  createdAt: number,
}
// Indexes: by_clerk, by_email

{
  userId: string,     // Clerk user ID
  ideaId: Id<"ideas">,
  type: string,       // "viewed" | "interested" | "not_interested" | "saved" | "building"
  createdAt: number,
}
// Indexes: by_user, by_idea, by_user_idea

7 Pages & Layouts

What each page looks like and does.

Browse Page (/ideas) — The Main Page

This is the heart of the app. Matches IdeaBrowser's browse layout.

Idea Card Structure (Unlocked)

Idea Card Structure (Locked)

Idea Detail Page (/ideas/[slug])

Full report page with all sections: Problem, Solution, Scores, Trend chart, Offer ladder, Why Now, Proof & Signals, Market Gap, Execution Plan, Framework Fit, AI chat.

Expired Page

Shown when a free user tries to view an expired idea. Orange "Expired" badge, teaser image, "Explore Plans" + "See Today's Free Idea" CTAs.

Pricing Page (/pricing)

Clerk's <PricingTable> component renders Stripe checkout. Shows Free vs Member plans with feature comparison.

8 Components

React components to build.

9 Colors & Design Tokens

Match IdeaBrowser's palette.

Primary Palette

Grays

Usage Rules

10 Typography

11 Auth Flow

Clerk handles everything. Zero custom auth code.

// convex/users.ts
export const createOrUpdateUser = mutation({
  handler: async (ctx) => {
    const identity = await ctx.auth.getUserIdentity();
    if (!identity) throw new Error("Not authenticated");
    
    const existing = await ctx.db.query("users")
      .withIndex("by_clerk", q => q.eq("clerkId", identity.subject))
      .first();
    
    if (!existing) {
      await ctx.db.insert("users", {
        clerkId: identity.subject,
        email: identity.email!,
        memberLevel: "free",  // "free" | "founder" | "lifetime"
        lastLoginAt: Date.now(),
        createdAt: Date.now(),
      });
    } else {
      await ctx.db.patch(existing._id, { lastLoginAt: Date.now() });
    }
  },
});

12 Payment Flow

Clerk Billing connects to Stripe. No webhook wiring needed.

13 24-Hour Expiry Logic

Convex cron job handles automatic expiry.

// convex/cron.ts
import { cronJobs } from "convex/server";
import { internal } from "./_generated/api";

const crons = cronJobs();
crons.interval("expire old ideas", { hours: 1 }, internal.ideas.expireOld);
export default crons;

// convex/ideas.ts
export const expireOld = mutation({
  handler: async (ctx) => {
    const now = Date.now();
    const liveIdeas = await ctx.db.query("ideas")
      .withIndex("by_status", q => q.eq("status", "live"))
      .collect();
    
    for (const idea of liveIdeas) {
      if (idea.expiresAt <= now) {
        await ctx.db.patch(idea._id, { 
          status: "expired",
          isIdeaOfTheDay: false,
        });
      }
    }
  },
});

Publishing New Ideas

Admin script or dashboard publishes at midnight UTC:

• Sets publishedAt = Date.now()
• Sets expiresAt = publishedAt + 24 * 60 * 60 * 1000
• Sets status = "live", isIdeaOfTheDay = true
• Previous day's idea auto-expires via cron

14 File Structure

digitalassetideas/
├── convex/
│   ├── schema.ts           # Database schema (ideas, users, interactions)
│   ├── ideas.ts            # Idea queries & mutations
│   ├── users.ts            # User queries & mutations
│   ├── interactions.ts     # User interaction tracking
│   ├── cron.ts             # Expiry cron jobs
│   ├── auth.config.ts      # Clerk auth config
│   └── _generated/         # Auto-generated Convex types
├── src/
│   ├── app/
│   │   ├── layout.tsx          # Root layout (ClerkProvider + ConvexProvider)
│   │   ├── page.tsx            # Home → redirect to /ideas
│   │   ├── ideas/
│   │   │   ├── page.tsx        # Browse page (SSR)
│   │   │   └── [slug]/
│   │   │       └── page.tsx    # Idea detail (SSR, checks expiry)
│   │   ├── pricing/
│   │   │   └── page.tsx        # Clerk PricingTable
│   │   └── api/
│   │       └── webhooks/
│   │           └── stripe/
│   │               └── route.ts # Stripe webhook (fallback)
│   ├── components/
│   │   ├── IdeaCard.tsx
│   │   ├── IdeaThumbnail.tsx
│   │   ├── LockedOverlay.tsx
│   │   ├── AuthModal.tsx
│   │   ├── FilterTabs.tsx
│   │   ├── SearchBar.tsx
│   │   ├── Pagination.tsx
│   │   ├── WelcomeBanner.tsx
│   │   └── Header.tsx
│   ├── lib/
│   │   ├── convex.ts           # Convex client setup
│   │   └── utils.ts            # Helpers
│   └── middleware.ts           # Clerk auth middleware (edge)
├── public/
├── .env.local
├── package.json
├── tailwind.config.ts
├── next.config.js
└── tsconfig.json

15 Environment Variables

# Convex
NEXT_PUBLIC_CONVEX_URL=https://your-deployment.convex.cloud

# Clerk
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...

# Stripe (if using direct Stripe instead of Clerk Billing)
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

16 Getting Started

Step-by-step build instructions for the AI agent.

17 Seed Data

12 sample ideas for testing. All home improvement lead gen niches.

18 Roadmap

V1 (Launch)

• ✅ Browse page with filter tabs, search, pagination
• ✅ Idea cards with thumbnails, scores, action buttons
• ✅ Locked card blur effect + Members Only overlay
• ✅ Auth: magic link + Google OAuth via Clerk
• ✅ Payment: Clerk Billing → Stripe checkout
• ✅ 24-hour expiry via Convex cron
• ✅ Idea detail page with full report
• ✅ Expired page with teaser + paywall CTA

V2 (Growth)

• ⬜ Email digest (daily idea to inbox)
• ⬜ AI-powered idea generator (custom niche + keyword)
• ⬜ "Build with AI Studio" integration
• ⬜ Idea feedback/rating system
• ⬜ Niche-specific filtering (HVAC, roofing, solar tabs)
• ⬜ Referral program (share link → free month)

V3 (Scale)

• ⬜ Mobile app (React Native + Convex)
• ⬜ API for third-party integrations
• ⬜ White-label licensing for agencies
• ⬜ Community features (comments, discussions)