rahman-resources 0.1.0 → 0.3.0

package/lib/manifest.json

@@ -1,8 +1,9 @@
 {
-  "generatedAt": "2026-05-03T14:23:54.502Z",
+  "version": 2,
+  "generatedAt": "2026-05-05T12:19:53.839Z",
   "repo": "rahmanef63/resource-site",
   "branch": "main",
-  "templates": [
+  "layouts": [
     {
       "slug": "personal-brand-os",
       "title": "Personal Brand OS",
@@ -16,6 +17,9 @@
         "convex/templates/personal-brand-os"
       ],
       "files": [
+        "app/preview/personal-brand-os/robots.ts",
+        "app/preview/personal-brand-os/sitemap.ts",
+        "app/preview/personal-brand-os/opengraph-image.tsx",
         "app/preview/personal-brand-os/public/layout.tsx",
         "app/preview/personal-brand-os/public/page.tsx",
         "app/preview/personal-brand-os/public/blog/page.tsx",
@@ -32,17 +36,51 @@
         "app/preview/personal-brand-os/admin/posts/new/page.tsx",
         "app/preview/personal-brand-os/admin/posts/[id]/page.tsx",
         "app/preview/personal-brand-os/admin/portfolio/page.tsx",
+        "app/preview/personal-brand-os/admin/portfolio/new/page.tsx",
+        "app/preview/personal-brand-os/admin/portfolio/[id]/page.tsx",
+        "app/preview/personal-brand-os/admin/services/page.tsx",
+        "app/preview/personal-brand-os/admin/resources/page.tsx",
         "app/preview/personal-brand-os/admin/leads/page.tsx",
         "app/preview/personal-brand-os/admin/comments/page.tsx",
         "app/preview/personal-brand-os/admin/chatbot/page.tsx",
+        "app/preview/personal-brand-os/admin/newsletter/page.tsx",
+        "app/preview/personal-brand-os/admin/analytics/page.tsx",
+        "app/preview/personal-brand-os/admin/settings/site/page.tsx",
+        "app/preview/personal-brand-os/admin/settings/team/page.tsx",
+        "app/preview/personal-brand-os/admin/settings/ai/page.tsx",
         "components/templates/personal-brand/shared/types.ts",
         "components/templates/personal-brand/shared/store.tsx",
         "components/templates/personal-brand/shared/seed.ts",
+        "components/templates/personal-brand/shared/site-config.ts",
         "components/templates/personal-brand/shared/ui/site-nav.tsx",
         "components/templates/personal-brand/shared/ui/site-footer.tsx",
         "components/templates/personal-brand/shared/ui/chat-fab.tsx",
+        "components/templates/personal-brand/shared/ui/section-head.tsx",
+        "components/templates/personal-brand/slices/home/HomePage.tsx",
+        "components/templates/personal-brand/slices/home/NewsletterBlock.tsx",
+        "components/templates/personal-brand/slices/blog/BlogList.tsx",
+        "components/templates/personal-brand/slices/blog/BlogDetail.tsx",
+        "components/templates/personal-brand/slices/portfolio/PortfolioListPage.tsx",
+        "components/templates/personal-brand/slices/portfolio/PortfolioDetailPage.tsx",
+        "components/templates/personal-brand/slices/services/ServicesPage.tsx",
+        "components/templates/personal-brand/slices/resources/ResourcesPage.tsx",
+        "components/templates/personal-brand/slices/about/AboutPage.tsx",
+        "components/templates/personal-brand/slices/contact/ContactPage.tsx",
         "components/templates/personal-brand/slices/admin/shell/admin-sidebar.tsx",
         "components/templates/personal-brand/slices/admin/shell/admin-topbar.tsx",
+        "components/templates/personal-brand/slices/admin/dashboard/DashboardView.tsx",
+        "components/templates/personal-brand/slices/admin/posts/PostsList.tsx",
+        "components/templates/personal-brand/slices/admin/posts/PostEditor.tsx",
+        "components/templates/personal-brand/slices/admin/portfolio/PortfolioListAdmin.tsx",
+        "components/templates/personal-brand/slices/admin/portfolio/PortfolioEditor.tsx",
+        "components/templates/personal-brand/slices/admin/services/ServicesAdminView.tsx",
+        "components/templates/personal-brand/slices/admin/resources/ResourcesAdminView.tsx",
+        "components/templates/personal-brand/slices/admin/leads/LeadsView.tsx",
+        "components/templates/personal-brand/slices/admin/comments/CommentsView.tsx",
+        "components/templates/personal-brand/slices/admin/chatbot/ChatbotAdminView.tsx",
+        "components/templates/personal-brand/slices/admin/newsletter/NewsletterView.tsx",
+        "components/templates/personal-brand/slices/admin/analytics/AnalyticsView.tsx",
+        "components/templates/personal-brand/slices/admin/settings/SettingsView.tsx",
         "convex/templates/personal-brand-os/schema.ts",
         "convex/templates/personal-brand-os/posts.ts",
         "convex/templates/personal-brand-os/portfolio.ts",
@@ -64,9 +102,18 @@
         "next-themes",
         "tailwindcss@^4",
         "convex",
-        "@convex-dev/auth"
+        "@convex-dev/auth",
+        "@radix-ui/react-avatar",
+        "@radix-ui/react-dialog",
+        "@radix-ui/react-dropdown-menu",
+        "@radix-ui/react-label",
+        "@radix-ui/react-scroll-area",
+        "@radix-ui/react-select",
+        "@radix-ui/react-separator",
+        "@radix-ui/react-slot",
+        "@radix-ui/react-tabs"
       ],
-      "agentRecipe": "Personal Brand OS = full-app template (public + admin). Copy sections from app/preview/personal-brand-os/public/page.tsx into app/(public)/sections/. Copy admin shell from app/preview/personal-brand-os/admin/page.tsx into app/(admin)/. Wire posts/portfolio/leads/chatbot/comments to Convex per docs/templates/T1-personal-brand-os.md schema. Replace lorem ipsum with real content via the CMS module.",
+      "agentRecipe": "Personal Brand OS = full-app template (public + admin). 1) Move app/preview/personal-brand-os/{robots,sitemap,opengraph-image}.* to app root. 2) Copy app/preview/personal-brand-os/public into app/(public)/, app/preview/personal-brand-os/admin into app/(admin)/. 3) Edit components/templates/personal-brand/shared/site-config.ts — set brandName, ownerName, baseUrl, twitter, email. 4) Wire convex/templates/personal-brand-os/* to convex/_generated and add @convex-dev/auth on admin routes. 5) Replace localStorage StoreProvider with Convex queries (schema mirrors localStorage shape).",
       "tags": [
         "template",
         "personal-brand",
@@ -74,7 +121,8 @@
         "portfolio",
         "admin",
         "saas"
-      ]
+      ],
+      "primaryFile": "app/preview/personal-brand-os/public/page.tsx"
     },
     {
       "slug": "landing-hero-carousel",
@@ -84,7 +132,7 @@
       "source": "cescadesigns",
       "repoPath": "cookbook/layouts/landing-hero-carousel",
       "pullPaths": [
-        "cookbook/layouts/landing-hero-carousel"
+        "app/preview/landing-hero-carousel"
       ],
       "files": [],
       "dependencies": [],
@@ -94,7 +142,8 @@
         "carousel",
         "image",
         "cms"
-      ]
+      ],
+      "primaryFile": "src/HeroSection.tsx"
     },
     {
       "slug": "landing-asymmetric-masonry",
@@ -104,7 +153,7 @@
       "source": "rahmanef.com",
       "repoPath": "cookbook/layouts/landing-asymmetric-masonry",
       "pullPaths": [
-        "cookbook/layouts/landing-asymmetric-masonry"
+        "app/preview/landing-asymmetric-masonry"
       ],
       "files": [],
       "dependencies": [],
@@ -114,7 +163,8 @@
         "portfolio",
         "masonry",
         "scroll-reveal"
-      ]
+      ],
+      "primaryFile": "src/PortfolioGrid.tsx"
     },
     {
       "slug": "landing-bento",
@@ -124,7 +174,7 @@
       "source": "synthesized",
       "repoPath": "cookbook/layouts/landing-bento",
       "pullPaths": [
-        "cookbook/layouts/landing-bento"
+        "app/preview/landing-bento"
       ],
       "files": [],
       "dependencies": [],
@@ -133,7 +183,8 @@
         "marketing",
         "bento",
         "features"
-      ]
+      ],
+      "primaryFile": "README.md"
     },
     {
       "slug": "landing-kinetic-text",
@@ -143,7 +194,7 @@
       "source": "rahmanef.com",
       "repoPath": "cookbook/layouts/landing-kinetic-text",
       "pullPaths": [
-        "cookbook/layouts/landing-kinetic-text"
+        "app/preview/landing-kinetic-text"
       ],
       "files": [],
       "dependencies": [],
@@ -152,7 +203,8 @@
         "marketing",
         "motion",
         "type"
-      ]
+      ],
+      "primaryFile": "README.md"
     },
     {
       "slug": "dashboard-three-column",
@@ -162,7 +214,7 @@
       "source": "kitab-core",
       "repoPath": "cookbook/layouts/dashboard-three-column",
       "pullPaths": [
-        "cookbook/layouts/dashboard-three-column"
+        "app/preview/dashboard-three-column"
       ],
       "files": [],
       "dependencies": [],
@@ -172,7 +224,8 @@
         "three-column",
         "resizable",
         "responsive"
-      ]
+      ],
+      "primaryFile": "template-base/frontend/shared/ui/layout/container/three-column/ThreeColumnLayout.tsx"
     },
     {
       "slug": "dashboard-ide",
@@ -182,7 +235,7 @@
       "source": "synthesized",
       "repoPath": "cookbook/layouts/dashboard-ide",
       "pullPaths": [
-        "cookbook/layouts/dashboard-ide"
+        "app/preview/dashboard-ide"
       ],
       "files": [],
       "dependencies": [],
@@ -191,7 +244,8 @@
         "dashboard",
         "ide",
         "editor"
-      ]
+      ],
+      "primaryFile": "README.md"
     },
     {
       "slug": "dashboard-mobile-dock",
@@ -201,7 +255,7 @@
       "source": "kitab-core",
       "repoPath": "cookbook/layouts/dashboard-mobile-dock",
       "pullPaths": [
-        "cookbook/layouts/dashboard-mobile-dock"
+        "app/preview/dashboard-mobile-dock"
       ],
       "files": [],
       "dependencies": [],
@@ -210,7 +264,8 @@
         "dashboard",
         "mobile",
         "pwa"
-      ]
+      ],
+      "primaryFile": "template-base/frontend/shared/ui/layout/dashboard/MobileDashboardShell.tsx"
     },
     {
       "slug": "cms-public-storefront",
@@ -220,7 +275,7 @@
       "source": "kitab-core cms-lite",
       "repoPath": "cookbook/layouts/cms-public-storefront",
       "pullPaths": [
-        "cookbook/layouts/cms-public-storefront"
+        "app/preview/cms-public-storefront"
       ],
       "files": [],
       "dependencies": [],
@@ -229,6 +284,320 @@
         "cms",
         "ecommerce",
         "storefront"
+      ],
+      "primaryFile": "README.md"
+    }
+  ],
+  "recipes": [
+    {
+      "slug": "block-editor",
+      "title": "Notion-Style Block Editor",
+      "description": "21-block contenteditable editor with slash command menu, markdown shortcuts, drag handles. Real-time via Convex.",
+      "source": "notion-page-clone",
+      "files": [
+        "frontend/slices/notion/slices/editor/BlockEditor.tsx",
+        "frontend/slices/notion/slices/editor/SlashMenu.tsx",
+        "frontend/slices/notion/slices/editor/blockSpecs.ts"
+      ],
+      "exampleCode": "import { BlockEditor } from \"@/frontend/slices/notion/slices/editor/BlockEditor\";\n\n<BlockEditor pageId={pageId} />",
+      "agentRecipe": "Already copied at frontend/slices/notion/slices/editor/. See PORT-NOTION.md for Vite→Next port checklist (routing rewrite, use-client markers, Convex API surface rename).",
+      "tags": [
+        "editor",
+        "notion",
+        "blocks",
+        "real-time"
+      ]
+    },
+    {
+      "slug": "page-tree-sidebar",
+      "title": "Page Tree Sidebar",
+      "description": "Hierarchical workspace sidebar with @dnd-kit drag-drop reordering, favorites, recents.",
+      "source": "notion-page-clone",
+      "files": [
+        "frontend/slices/notion/slices/workspace-sidebar/components/WorkspaceSidebar.tsx",
+        "frontend/slices/notion/slices/workspace-sidebar/components/SortablePageRow.tsx"
+      ],
+      "exampleCode": "import { WorkspaceSidebar } from \"@/frontend/slices/notion/slices/workspace-sidebar/components/WorkspaceSidebar\";\n\n<WorkspaceSidebar />",
+      "agentRecipe": "Mount WorkspaceSidebar inside the left slot of <ThreeColumnLayout>. State backed by Zustand store at frontend/slices/notion/shared/lib/store.tsx.",
+      "tags": [
+        "sidebar",
+        "tree",
+        "dnd-kit",
+        "navigation"
+      ]
+    },
+    {
+      "slug": "multi-block-selection",
+      "title": "Multi-Block Selection",
+      "description": "Marquee + click+shift selection of editor blocks with floating toolbar. Bulk actions: delete, duplicate, convert.",
+      "source": "notion-page-clone",
+      "files": [
+        "frontend/slices/notion/slices/block-selection/components/BlockSelectionProvider.tsx",
+        "frontend/slices/notion/slices/block-selection/components/MarqueeOverlay.tsx"
+      ],
+      "exampleCode": "import { BlockSelectionProvider } from \"@/frontend/slices/notion/slices/block-selection/components/BlockSelectionProvider\";\n\n<BlockSelectionProvider>\n  <BlockEditor />\n</BlockSelectionProvider>",
+      "agentRecipe": "Wrap BlockEditor with BlockSelectionProvider. The marquee overlay attaches to document; toolbar floats above the selection bounding box.",
+      "tags": [
+        "selection",
+        "editor",
+        "bulk",
+        "marquee"
+      ]
+    },
+    {
+      "slug": "database-views",
+      "title": "Database Views (11 types)",
+      "description": "Properties+rows database with 11 view types: table, board, calendar, timeline, chart, gallery, map. Per-view filter/sort/group.",
+      "source": "notion-page-clone",
+      "files": [
+        "frontend/slices/notion/slices/databases/DatabaseBlock.tsx",
+        "frontend/slices/notion/slices/databases/views/TableView.tsx",
+        "frontend/slices/notion/slices/databases/views/BoardView.tsx"
+      ],
+      "exampleCode": "import { DatabaseBlock } from \"@/frontend/slices/notion/slices/databases/DatabaseBlock\";\n\n<DatabaseBlock databaseId={dbId} />",
+      "agentRecipe": "DatabaseBlock auto-routes to the active view component. Add custom property types by extending PropertyCell.tsx.",
+      "tags": [
+        "database",
+        "views",
+        "table",
+        "kanban",
+        "calendar"
+      ]
+    },
+    {
+      "slug": "command-palette",
+      "title": "Command Palette (⌘K)",
+      "description": "Cmd+K modal: feature navigation, workspace switching, theme, sign-out, custom commands. Auto-builds from feature registry.",
+      "source": "kitab-core + notion-page-clone",
+      "files": [
+        "frontend/shared/foundation/utils/system/command-menu/components.tsx"
+      ],
+      "exampleCode": "import { CommandMenu } from \"@/frontend/shared/foundation/utils/system/command-menu/components\";\n\n<CommandMenu actions={customActions} />",
+      "agentRecipe": "Mount CommandMenu once at the app shell level. It listens for Cmd+K globally. Pass extra commands via the actions prop or register via the command-registry.",
+      "tags": [
+        "palette",
+        "cmd-k",
+        "navigation"
+      ]
+    },
+    {
+      "slug": "comments-threaded",
+      "title": "Threaded Comments",
+      "description": "Page + block-level threaded comments with resolved state. Real-time via Convex.",
+      "source": "notion-page-clone",
+      "files": [
+        "frontend/slices/notion/slices/comments/components/BlockCommentsPopover.tsx",
+        "frontend/slices/notion/slices/comments/hooks/useComments.ts"
+      ],
+      "exampleCode": "import { BlockCommentsPopover } from \"@/frontend/slices/notion/slices/comments/components/BlockCommentsPopover\";\n\n<BlockCommentsPopover blockId={blockId} pageId={pageId} />",
+      "agentRecipe": "Anchor comments by passing pageId (always) and optional blockId. Use useComments(blockId) hook for the reactive list.",
+      "tags": [
+        "comments",
+        "real-time",
+        "threading"
+      ]
+    },
+    {
+      "slug": "theme-preset-switcher",
+      "title": "Theme Preset Switcher",
+      "description": "Runtime theme swap (colors + fonts + shadows + tracking). OKLch CSS vars per preset. Persists to localStorage + Convex.",
+      "source": "rahmanef.com",
+      "files": [
+        "frontend/shared/theme/theme-presets.ts",
+        "frontend/shared/ui/components/theme-preset-switcher.tsx"
+      ],
+      "exampleCode": "import { ThemePresetSwitcher } from \"@/frontend/shared/ui/components/theme-preset-switcher\";\n\n<ThemePresetSwitcher />",
+      "agentRecipe": "Add a new preset by appending a CSS block in app/globals.css with [data-theme=\"<name>\"], then register in preset-groups.ts.",
+      "tags": [
+        "theme",
+        "presets",
+        "oklch",
+        "design-system"
+      ]
+    },
+    {
+      "slug": "contact-form-resend",
+      "title": "Contact Form + Resend",
+      "description": "Contact form posting to Resend email API. Server Action + Zod input validation.",
+      "source": "cescadesigns",
+      "files": [
+        "recipes/contact-form-resend/src/page.tsx"
+      ],
+      "exampleCode": "// app/api/contact/route.ts\nimport { Resend } from \"resend\";\nconst resend = new Resend(process.env.RESEND_API_KEY!);\n\nexport async function POST(req: Request) {\n  const data = await req.formData();\n  await resend.emails.send({\n    from: \"form@yourdomain.com\",\n    to: \"you@yourdomain.com\",\n    subject: `From ${data.get(\"name\")}`,\n    html: `<p>${data.get(\"message\")}</p>`,\n  });\n  return Response.json({ ok: true });\n}",
+      "agentRecipe": "Wire ContactForm.tsx (form action /api/contact) to the route handler. Always validate inputs with Zod server-side.",
+      "tags": [
+        "form",
+        "email",
+        "resend",
+        "server-action"
+      ]
+    }
+  ],
+  "features": [
+    {
+      "slug": "ai-sdk-openrouter",
+      "title": "AI SDK — OpenRouter Router",
+      "category": "ai",
+      "description": "Tier-routed LLM calls via OpenRouter. Nano (Haiku/4o-mini) for classification, mid (Sonnet/4o) for drafting, flagship (Opus) for deep reasoning. Cost log + retry baked in.",
+      "source": "@openrouter/ai-sdk-provider + ai",
+      "docsUrl": "https://sdk.vercel.ai/docs",
+      "install": "npm i ai @openrouter/ai-sdk-provider",
+      "npmPackages": [
+        "ai",
+        "@openrouter/ai-sdk-provider"
+      ],
+      "exampleCode": "// convex/shared/ai/router.ts\nimport { action } from \"./_generated/server\";\nimport { v } from \"convex/values\";\nimport { generateText } from \"ai\";\nimport { createOpenRouter } from \"@openrouter/ai-sdk-provider\";\n\nconst router = createOpenRouter({ apiKey: process.env.OPENROUTER_API_KEY! });\n\nconst TIER_TO_MODEL = {\n  nano: \"anthropic/claude-haiku-4-5\",\n  mid: \"anthropic/claude-sonnet-4-6\",\n  flagship: \"anthropic/claude-opus-4-7\",\n};\n\nexport const callModel = action({\n  args: {\n    feature: v.string(),\n    prompt: v.string(),\n    tier: v.union(v.literal(\"nano\"), v.literal(\"mid\"), v.literal(\"flagship\")),\n  },\n  handler: async (ctx, { feature, prompt, tier }) => {\n    const { text, usage } = await generateText({\n      model: router(TIER_TO_MODEL[tier]),\n      prompt,\n    });\n    await ctx.runMutation(internal.ai.logUsage, { feature, tier, usage });\n    return text;\n  },\n});",
+      "agentRecipe": "Wrap every AI call through ai-router action. Pick tier based on workload: nano for spam-flag/headline-suggest, mid for chat/draft, flagship for methodology-review. Log token usage to ai_usage table for cost dashboard.",
+      "tags": [
+        "ai",
+        "llm",
+        "openrouter",
+        "vercel-ai-sdk"
+      ]
+    },
+    {
+      "slug": "convex-auth",
+      "title": "Convex Auth — Email Magic Link",
+      "category": "auth",
+      "description": "@convex-dev/auth with email magic link only. No Clerk, no NextAuth. Self-hosted Convex friendly. Hard mandate per kitab CLAUDE.md.",
+      "source": "@convex-dev/auth",
+      "docsUrl": "https://labs.convex.dev/auth",
+      "install": "npm i @convex-dev/auth @auth/core resend",
+      "npmPackages": [
+        "@convex-dev/auth",
+        "@auth/core",
+        "resend"
+      ],
+      "exampleCode": "// convex/auth.ts\nimport { convexAuth } from \"@convex-dev/auth/server\";\nimport { ResendOTP } from \"./auth/ResendOTP\";\n\nexport const { auth, signIn, signOut, store, isAuthenticated } = convexAuth({\n  providers: [ResendOTP],\n});\n\n// app/proxy.ts (Next 16 — NOT middleware.ts)\nimport { convexAuthNextjsMiddleware } from \"@convex-dev/auth/nextjs/server\";\nexport default convexAuthNextjsMiddleware();",
+      "agentRecipe": "Mount auth in convex/auth.ts. Wire ResendOTP for magic-link delivery. Use convexAuthNextjsMiddleware in app/proxy.ts (Next 16 renamed middleware.ts → proxy.ts). Forbid Clerk per CLAUDE.md.",
+      "tags": [
+        "auth",
+        "convex",
+        "email-magic-link",
+        "no-clerk"
+      ]
+    },
+    {
+      "slug": "broadcast-channel-sync",
+      "title": "BroadcastChannel — Cross-iframe Live Sync",
+      "category": "realtime",
+      "description": "Same-origin iframe live sync without backend. Used in T1 split preview tab — submit form di Public, action propagates ke Admin secara realtime via window.BroadcastChannel.",
+      "source": "Web Platform — BroadcastChannel API",
+      "docsUrl": "https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API",
+      "install": "// no install — Web Platform API",
+      "npmPackages": [],
+      "exampleCode": "\"use client\";\nimport * as React from \"react\";\n\nexport function StoreProvider({ children }) {\n  const [state, baseDispatch] = React.useReducer(reducer, SEED_STATE);\n  const channelRef = React.useRef<BroadcastChannel | null>(null);\n\n  React.useEffect(() => {\n    const ch = new BroadcastChannel(\"pbos:sync\");\n    channelRef.current = ch;\n    ch.onmessage = (e) => baseDispatch(e.data);\n    return () => ch.close();\n  }, []);\n\n  const dispatch = React.useCallback((action) => {\n    baseDispatch(action);\n    channelRef.current?.postMessage(action);\n  }, []);\n\n  return <Ctx.Provider value={{ state, dispatch }}>{children}</Ctx.Provider>;\n}",
+      "agentRecipe": "Use BroadcastChannel only for demo / cross-iframe state mirroring. Production data still goes through Convex realtime. The channel does not echo to the sender so no loop.",
+      "tags": [
+        "realtime",
+        "broadcast-channel",
+        "cross-iframe",
+        "demo-pattern"
+      ]
+    },
+    {
+      "slug": "convex-vector-search",
+      "title": "Convex Vector Index — Semantic Search",
+      "category": "search",
+      "description": "Built-in vector index on any Convex table. Embed via OpenAI text-embedding-3-small (1536-dim), query via vectorIndex().",
+      "source": "convex (built-in)",
+      "docsUrl": "https://docs.convex.dev/database/vector-search",
+      "install": "npm i openai",
+      "npmPackages": [
+        "openai"
+      ],
+      "exampleCode": "// convex/schema.ts\nposts: defineTable({\n  title: v.string(),\n  body: v.string(),\n  embedding: v.array(v.float64()),\n}).vectorIndex(\"by_embedding\", {\n  vectorField: \"embedding\",\n  dimensions: 1536,\n  filterFields: [\"workspaceId\", \"status\"],\n}),\n\n// convex/posts.ts\nexport const search = action({\n  args: { query: v.string(), workspaceId: v.id(\"workspaces\") },\n  handler: async (ctx, args) => {\n    const emb = await embed(args.query);\n    return await ctx.vectorSearch(\"posts\", \"by_embedding\", {\n      vector: emb,\n      limit: 10,\n      filter: (q) => q.eq(\"workspaceId\", args.workspaceId),\n    });\n  },\n});",
+      "agentRecipe": "Add embedding field + vectorIndex per searchable table. Re-embed on upsert via Convex action. Cache embeddings — don't re-call OpenAI on every read.",
+      "tags": [
+        "search",
+        "vector",
+        "convex",
+        "rag"
+      ]
+    },
+    {
+      "slug": "resend-newsletter",
+      "title": "Resend — Transactional & Newsletter",
+      "category": "email",
+      "description": "Transactional email + newsletter blast via Resend. Double opt-in flow + audience segmentation. Magic-link delivery for Convex Auth.",
+      "source": "resend + react-email",
+      "docsUrl": "https://resend.com/docs",
+      "install": "npm i resend react-email @react-email/components",
+      "npmPackages": [
+        "resend",
+        "react-email",
+        "@react-email/components"
+      ],
+      "exampleCode": "// convex/shared/email/resend.ts\nimport { Resend } from \"resend\";\nimport { action } from \"../../_generated/server\";\n\nconst resend = new Resend(process.env.RESEND_API_KEY!);\n\nexport const sendNewsletter = action({\n  args: { audienceId: v.string(), subject: v.string(), html: v.string() },\n  handler: async (_, args) => {\n    await resend.broadcasts.create({\n      audienceId: args.audienceId,\n      from: \"lorem.dev <hi@lorem.dev>\",\n      subject: args.subject,\n      html: args.html,\n    });\n  },\n});",
+      "agentRecipe": "Use Resend Audiences API for newsletter — store subscriber emails in Convex too for segmentation. Double opt-in: subscriber.create with status 'pending' → click link → status 'confirmed'.",
+      "tags": [
+        "email",
+        "resend",
+        "newsletter",
+        "transactional"
+      ]
+    },
+    {
+      "slug": "midtrans-payment",
+      "title": "Midtrans — Indonesia Payment",
+      "category": "payment",
+      "description": "Pembayaran lokal Indonesia via Midtrans Snap (BCA, Mandiri, BRI, e-wallet GoPay/OVO/Dana, QRIS). Webhook untuk konfirmasi.",
+      "source": "midtrans-client",
+      "docsUrl": "https://docs.midtrans.com",
+      "install": "npm i midtrans-client",
+      "npmPackages": [
+        "midtrans-client"
+      ],
+      "exampleCode": "// convex/shared/billing/midtrans.ts\nimport midtransClient from \"midtrans-client\";\nimport { action } from \"../../_generated/server\";\n\nconst snap = new midtransClient.Snap({\n  isProduction: false,\n  serverKey: process.env.MIDTRANS_SERVER_KEY!,\n});\n\nexport const createPayment = action({\n  args: { orderId: v.string(), amount: v.number(), customer: v.any() },\n  handler: async (_, args) => {\n    const tx = await snap.createTransaction({\n      transaction_details: { order_id: args.orderId, gross_amount: args.amount },\n      customer_details: args.customer,\n    });\n    return tx.redirect_url;\n  },\n});",
+      "agentRecipe": "Midtrans Snap untuk pembayaran instant. Webhook ke Convex HTTP action /api/midtrans-callback untuk update order status. Ingat: PPN 11% sudah included di amount, jangan double-count.",
+      "tags": [
+        "payment",
+        "midtrans",
+        "indonesia",
+        "qris"
+      ]
+    },
+    {
+      "slug": "mdx-blog",
+      "title": "MDX — Blog Content",
+      "category": "content",
+      "description": "Markdown-with-JSX untuk blog post. Auto-generate ToC, reading-time, syntax highlight, plus embed React components inline.",
+      "source": "next-mdx-remote",
+      "docsUrl": "https://github.com/hashicorp/next-mdx-remote",
+      "install": "npm i next-mdx-remote rehype-pretty-code remark-gfm reading-time",
+      "npmPackages": [
+        "next-mdx-remote",
+        "rehype-pretty-code",
+        "remark-gfm",
+        "reading-time"
+      ],
+      "exampleCode": "// app/blog/[slug]/page.tsx\nimport { MDXRemote } from \"next-mdx-remote/rsc\";\nimport readingTime from \"reading-time\";\n\nexport default async function Page({ params }) {\n  const { slug } = await params;\n  const post = await getPost(slug);\n  const stats = readingTime(post.body);\n\n  return (\n    <article>\n      <h1>{post.title}</h1>\n      <p>{stats.text}</p>\n      <MDXRemote\n        source={post.body}\n        options={{ mdxOptions: { rehypePlugins: [rehypePrettyCode], remarkPlugins: [remarkGfm] } }}\n      />\n    </article>\n  );\n}",
+      "agentRecipe": "Store post body sebagai markdown di Convex. Render dengan MDXRemote di [slug]/page.tsx. Auto-extract headings ke ToC via remark plugin custom.",
+      "tags": [
+        "mdx",
+        "markdown",
+        "blog",
+        "content"
+      ]
+    },
+    {
+      "slug": "cal-com-booking",
+      "title": "Cal.com — Booking Embed",
+      "category": "data",
+      "description": "Embed Cal.com booking widget di halaman Services. Self-hosted atau cloud. Webhook ke Convex untuk sync booking ke leads table.",
+      "source": "@calcom/embed-react",
+      "docsUrl": "https://cal.com/docs/integrations/web-app/embed",
+      "install": "npm i @calcom/embed-react",
+      "npmPackages": [
+        "@calcom/embed-react"
+      ],
+      "exampleCode": "\"use client\";\nimport Cal from \"@calcom/embed-react\";\n\nexport function CalEmbed({ eventType }: { eventType: string }) {\n  return (\n    <Cal\n      calLink={`lorem/${eventType}`}\n      style={{ width: \"100%\", height: \"600px\", overflow: \"scroll\" }}\n      config={{ layout: \"month_view\", theme: \"dark\" }}\n    />\n  );\n}",
+      "agentRecipe": "Embed Cal.com via @calcom/embed-react di halaman services. Configure webhook di Cal.com dashboard → POST ke /api/cal-webhook → create lead di Convex.",
+      "tags": [
+        "booking",
+        "cal-com",
+        "scheduling",
+        "embed"
       ]
     }
   ]

package/lib/starter/_README.md

@@ -0,0 +1,37 @@
+# __APP_NAME__
+
+Scaffolded with [`rahman-resources`](https://www.npmjs.com/package/rahman-resources) — Next 16 + React 19 + Convex (self-hosted) + Tailwind 4 + shadcn/ui.
+
+## Setup
+
+```bash
+npm install --legacy-peer-deps
+cp .env.example .env.local           # fill NEXT_PUBLIC_CONVEX_URL etc.
+npx convex dev --once                 # generates convex/_generated
+npm run dev
+```
+
+## Add a layout / recipe / feature
+
+```bash
+npx rahman-resources list
+npx rahman-resources info <slug>
+npx rahman-resources add personal-brand-os .   # full-app template (T1)
+npx rahman-resources add ai-sdk-openrouter .   # feature (npm install)
+```
+
+## Hard rules
+
+- **NO Clerk.** Auth = `@convex-dev/auth`.
+- **shadcn primitives only** — no raw `<dialog>`, `<input type=date|file>`.
+- Use `proxy.ts` (not `middleware.ts`) on Next 16.
+- `convex/_generated` MUST be committed before deploy.
+
+## Stack
+
+| | |
+|---|---|
+| Framework | Next.js 16 (App Router + cacheComponents) |
+| UI | React 19 + Tailwind 4 + shadcn |
+| Backend | Convex (self-hosted compatible) |
+| Auth | `@convex-dev/auth` (Password provider by default) |

package/lib/starter/_env.example

@@ -0,0 +1,16 @@
+# Convex (self-hosted or cloud)
+NEXT_PUBLIC_CONVEX_URL=
+
+# @convex-dev/auth — required for auth signing
+JWKS=
+JWT_PRIVATE_KEY=
+SITE_URL=http://localhost:3000
+
+# Server actions encryption (multi-instance — pin once, share across instances)
+NEXT_SERVER_ACTIONS_ENCRYPTION_KEY=
+
+# Optional OAuth providers
+AUTH_GITHUB_ID=
+AUTH_GITHUB_SECRET=
+AUTH_GOOGLE_ID=
+AUTH_GOOGLE_SECRET=

package/lib/starter/_gitignore

@@ -0,0 +1,12 @@
+node_modules
+.next
+.turbo
+out
+dist
+.env*.local
+.env
+*.tsbuildinfo
+next-env.d.ts
+convex/_generated
+.vercel
+.DS_Store