rahman-resources 1.6.0 → 1.7.0

package/lib/manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 2,
-  "generatedAt": "2026-05-17T13:25:57.345Z",
+  "generatedAt": "2026-05-18T14:08:20.458Z",
   "repo": "rahmanef63/resource-site",
   "branch": "main",
   "layouts": [
@@ -1911,7 +1911,7 @@
       "install": "npx rahman-resources add admin",
       "npmPackages": [],
       "exampleCode": "",
-      "agentRecipe": "Run `rr add admin`. Wire <AdminPage labels={...} /> at /admin and call buildAdminStats({ sliceRegistry, queryTable }) inside convex/features/admin/queries.ts — sliceRegistry.entries flat-maps each feature's admin.activity[] declarations. Set SUPER_ADMIN_EMAIL via `npx convex env set` to lock down /admin to one address.",
+      "agentRecipe": "Run `rr add admin`. Wire <AdminPage labels={...} /> at /admin and call buildAdminStats({ sliceRegistry, queryTable }) inside convex/features/admin/query.ts — sliceRegistry.entries flat-maps each feature's admin.activity[] declarations. Set SUPER_ADMIN_EMAIL via `npx convex env set` to lock down /admin to one address.",
       "tags": [
         "infra",
         "admin",
@@ -2008,6 +2008,141 @@
         "job-search",
         "indonesia"
       ]
+    },
+    {
+      "slug": "pricing-page",
+      "title": "Pricing Page",
+      "category": "ui",
+      "description": "Canonical pricing tier section — eyebrow + headline + 2/3/4 column tier grid with optional FAQ accordion below. Tiers fully data-driven (name/price/period/bullets/cta/featured/badge). Featured variant configurable (ring/scale/tint). Single SSOT — every saas/marketing template consumes this slice for pricing pages so admin-edited tiers propagate without per-template rewriting.",
+      "source": "rahman-resources",
+      "install": "npx rahman-resources add pricing-page",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Run `npx rr add pricing-page`. <PricingSection eyebrow title subtitle tiers columns faq faqTitle featuredVariant /> — only `title` + `tiers` required. Each tier: `{ id, name, price, period?, blurb?, bullets[], cta?, featured?, badge? }`. Pass `featuredVariant=\"scale\"` for a popped-forward card or `\"tint\"` for a colored background. Wire admin CRUD via your store hook → useTiers() → pass array.",
+      "tags": [
+        "ui",
+        "pricing",
+        "section",
+        "marketing",
+        "saas",
+        "tiers",
+        "faq"
+      ]
+    },
+    {
+      "slug": "feature-grid",
+      "title": "Feature Grid",
+      "category": "ui",
+      "description": "Canonical features grid section — eyebrow + headline + 1/2/3/4 column item grid in three layout variants (cards, minimal, alternating). Items accept Lucide icon component OR string label, optional image (next/image), optional link CTA. Single SSOT — every template consumes this slice for features pages so admin-edited items propagate without per-template duplication.",
+      "source": "rahman-resources",
+      "install": "npx rahman-resources add feature-grid",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Run `npx rr add feature-grid`. <FeatureGridSection eyebrow title subtitle items columns layout align /> — only `items` required. Each item: `{ id, title, body, icon?, image?, link? }`. `icon` can be a LucideIcon component (rendered as 5×5 inline) or a string (rendered as letter fallback). `layout=\"alternating\"` produces image+text rows that flip per index — set `image` per item for that variant.",
+      "tags": [
+        "ui",
+        "features",
+        "section",
+        "marketing",
+        "grid",
+        "saas"
+      ]
+    },
+    {
+      "slug": "faq-section",
+      "title": "FAQ Section",
+      "category": "ui",
+      "description": "Canonical FAQ accordion section — eyebrow + headline + accordion item list. Three layouts (single column, two-column, grouped by category). Optional footer CTA (\"Still have questions?\"). Items fully data-driven. Single SSOT — every template consumes this slice for FAQ blocks so admin-edited Q&A propagates without per-template rewrite.",
+      "source": "rahman-resources",
+      "install": "npx rahman-resources add faq-section",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Run `npx rr add faq-section`. <FAQSection items title subtitle layout multiple defaultOpen footerCta /> — only `items` required. Each item: `{ id, q, a, category? }`. `layout=\"grouped\"` buckets by `category`. `multiple` lets users open several at once. `footerCta={{ label, href }}` wires a contact link below the accordion.",
+      "tags": [
+        "ui",
+        "faq",
+        "section",
+        "accordion",
+        "marketing"
+      ]
+    },
+    {
+      "slug": "testimonials-grid",
+      "title": "Testimonials Grid",
+      "category": "ui",
+      "description": "Canonical testimonials section — quote + author + role/company + optional avatar + optional star rating. Three layouts (uniform cards grid, centered quote-stack, CSS masonry). `featured` testimonials get a ring accent. Pairs naturally with the `testimonials` backend slice (Convex queries) but has zero coupling — pass any item array.",
+      "source": "rahman-resources",
+      "install": "npx rahman-resources add testimonials-grid",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Run `npx rr add testimonials-grid`. <TestimonialsGridSection items title subtitle columns layout align /> — only `items` required. Each item: `{ id, quote, author, role?, company?, avatar?, rating?, featured? }`. `layout=\"quote-stack\"` renders a centered no-card scroll for editorial sites. `layout=\"masonry\"` uses CSS columns for variable-height quotes.",
+      "tags": [
+        "ui",
+        "testimonials",
+        "section",
+        "marketing",
+        "social-proof",
+        "saas"
+      ]
+    },
+    {
+      "slug": "blog-section",
+      "title": "Blog Section",
+      "category": "ui",
+      "description": "Canonical blog list + detail section. <BlogListSection> renders 3 layouts (cards grid, minimal list, featured-split with hero + side rail). <BlogPostView> renders the single-post page with cover + meta + paragraph-split body. Both pass through `hrefFor`/`backHref` so each template controls routing — single SSOT for /blog and /blog/[slug] across all templates.",
+      "source": "rahman-resources",
+      "install": "npx rahman-resources add blog-section",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Run `npx rr add blog-section`. <BlogListSection posts hrefFor title columns layout limit /> for /blog — `hrefFor(post)` returns the per-post URL. <BlogPostView post backHref renderBody /> for /blog/[slug] — `renderBody` defaults to paragraph-split on `\\n\\n` (swap for an MDX renderer if you use mdx-blog).",
+      "tags": [
+        "ui",
+        "blog",
+        "section",
+        "marketing",
+        "content",
+        "list",
+        "detail"
+      ]
+    },
+    {
+      "slug": "changelog-feed",
+      "title": "Changelog Feed",
+      "category": "ui",
+      "description": "Canonical /changelog or /whats-new section. Entries support 5 kinds (feature/improvement/fix/chore/breaking) with color-coded badges. Three layouts (timeline with date-rail, large cards, minimal list). Optional `limit` for \"Recent updates\" excerpts on home pages. Optional `groups` per entry for sub-sectioned bullet lists.",
+      "source": "rahman-resources",
+      "install": "npx rahman-resources add changelog-feed",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Run `npx rr add changelog-feed`. <ChangelogFeedSection entries title subtitle layout sortDescending limit /> — only `entries` required. Each entry: `{ id, version, date, kind, title, body, bullets?, groups? }`. `layout=\"timeline\"` adds a left date-rail; `layout=\"list\"` is the most compact. Pass `limit={3}` on home pages to show recent releases.",
+      "tags": [
+        "ui",
+        "changelog",
+        "section",
+        "saas",
+        "release-notes",
+        "marketing"
+      ]
+    },
+    {
+      "slug": "portfolio-section",
+      "title": "Portfolio Section",
+      "category": "ui",
+      "description": "Canonical portfolio list + detail section. <PortfolioListSection> renders 3 layouts (uniform 16:9 grid, CSS masonry, asymmetric with featured hero). <PortfolioDetailView> renders title + meta + cover + body + gallery + external link + related items. Both pass through `hrefFor`/`backHref` so each template controls routing — single SSOT for /portfolio and /portfolio/[slug] across agency-studio and personal-brand.",
+      "source": "rahman-resources",
+      "install": "npx rahman-resources add portfolio-section",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Run `npx rr add portfolio-section`. <PortfolioListSection items hrefFor title columns layout limit /> for /portfolio — each item `{ id, slug, title, summary?, year?, client?, role?, tags?, cover: {src,alt}, gallery?, link? }`. <PortfolioDetailView item backHref renderBody related hrefForRelated /> for /portfolio/[slug] — `renderBody` defaults to paragraph split; override for project-specific layouts (problem/approach/result, brief/outcome, etc).",
+      "tags": [
+        "ui",
+        "portfolio",
+        "section",
+        "marketing",
+        "case-study",
+        "list",
+        "detail"
+      ]
     }
   ],
   "slices": [
@@ -3365,7 +3500,7 @@
         "crud",
         "nav-from-registry"
       ],
-      "agentRecipe": "Run `rr add admin`. Wire <AdminPage labels={...} /> at /admin and call buildAdminStats({ sliceRegistry, queryTable }) inside convex/features/admin/queries.ts — sliceRegistry.entries flat-maps each feature's admin.activity[] declarations. Set SUPER_ADMIN_EMAIL via `npx convex env set` to lock down /admin to one address."
+      "agentRecipe": "Run `rr add admin`. Wire <AdminPage labels={...} /> at /admin and call buildAdminStats({ sliceRegistry, queryTable }) inside convex/features/admin/query.ts — sliceRegistry.entries flat-maps each feature's admin.activity[] declarations. Set SUPER_ADMIN_EMAIL via `npx convex env set` to lock down /admin to one address."
     },
     {
       "slug": "platform-admin",
@@ -3560,6 +3695,233 @@
         "indonesia"
       ],
       "agentRecipe": "Run `rr add document-checklist`. Wire <DocumentChecklist bindings={{ current, seed, updateStatus }} countryTemplateSlot={<CountryTemplateCard bindings={{ templates, getTemplate, instantiate }} />} /> — bindings sourced from api.features['document-checklist'].* queries/mutations."
+    },
+    {
+      "slug": "pricing-page",
+      "title": "Pricing Page",
+      "category": "ui",
+      "kind": "ui",
+      "version": "0.1.0",
+      "description": "Canonical pricing tier section — eyebrow + headline + 2/3/4 column tier grid with optional FAQ accordion below. Tiers fully data-driven (name/price/period/bullets/cta/featured/badge). Featured variant configurable (ring/scale/tint). Single SSOT — every saas/marketing template consumes this slice for pricing pages so admin-edited tiers propagate without per-template rewriting.",
+      "source": "rahman-resources",
+      "slicePath": "frontend/slices/pricing-page",
+      "convexPaths": [],
+      "npm": [
+        "lucide-react@^0.400.0"
+      ],
+      "shadcn": [
+        "button",
+        "card",
+        "accordion"
+      ],
+      "env": [],
+      "peers": [],
+      "providers": [],
+      "tags": [
+        "ui",
+        "pricing",
+        "section",
+        "marketing",
+        "saas",
+        "tiers",
+        "faq"
+      ],
+      "agentRecipe": "Run `npx rr add pricing-page`. <PricingSection eyebrow title subtitle tiers columns faq faqTitle featuredVariant /> — only `title` + `tiers` required. Each tier: `{ id, name, price, period?, blurb?, bullets[], cta?, featured?, badge? }`. Pass `featuredVariant=\"scale\"` for a popped-forward card or `\"tint\"` for a colored background. Wire admin CRUD via your store hook → useTiers() → pass array."
+    },
+    {
+      "slug": "feature-grid",
+      "title": "Feature Grid",
+      "category": "ui",
+      "kind": "ui",
+      "version": "0.1.0",
+      "description": "Canonical features grid section — eyebrow + headline + 1/2/3/4 column item grid in three layout variants (cards, minimal, alternating). Items accept Lucide icon component OR string label, optional image (next/image), optional link CTA. Single SSOT — every template consumes this slice for features pages so admin-edited items propagate without per-template duplication.",
+      "source": "rahman-resources",
+      "slicePath": "frontend/slices/feature-grid",
+      "convexPaths": [],
+      "npm": [
+        "lucide-react@^0.400.0"
+      ],
+      "shadcn": [
+        "button",
+        "card"
+      ],
+      "env": [],
+      "peers": [],
+      "providers": [],
+      "tags": [
+        "ui",
+        "features",
+        "section",
+        "marketing",
+        "grid",
+        "saas"
+      ],
+      "agentRecipe": "Run `npx rr add feature-grid`. <FeatureGridSection eyebrow title subtitle items columns layout align /> — only `items` required. Each item: `{ id, title, body, icon?, image?, link? }`. `icon` can be a LucideIcon component (rendered as 5×5 inline) or a string (rendered as letter fallback). `layout=\"alternating\"` produces image+text rows that flip per index — set `image` per item for that variant."
+    },
+    {
+      "slug": "faq-section",
+      "title": "FAQ Section",
+      "category": "ui",
+      "kind": "ui",
+      "version": "0.1.0",
+      "description": "Canonical FAQ accordion section — eyebrow + headline + accordion item list. Three layouts (single column, two-column, grouped by category). Optional footer CTA (\"Still have questions?\"). Items fully data-driven. Single SSOT — every template consumes this slice for FAQ blocks so admin-edited Q&A propagates without per-template rewrite.",
+      "source": "rahman-resources",
+      "slicePath": "frontend/slices/faq-section",
+      "convexPaths": [],
+      "npm": [],
+      "shadcn": [
+        "accordion",
+        "button"
+      ],
+      "env": [],
+      "peers": [],
+      "providers": [],
+      "tags": [
+        "ui",
+        "faq",
+        "section",
+        "accordion",
+        "marketing"
+      ],
+      "agentRecipe": "Run `npx rr add faq-section`. <FAQSection items title subtitle layout multiple defaultOpen footerCta /> — only `items` required. Each item: `{ id, q, a, category? }`. `layout=\"grouped\"` buckets by `category`. `multiple` lets users open several at once. `footerCta={{ label, href }}` wires a contact link below the accordion."
+    },
+    {
+      "slug": "testimonials-grid",
+      "title": "Testimonials Grid",
+      "category": "ui",
+      "kind": "ui",
+      "version": "0.1.0",
+      "description": "Canonical testimonials section — quote + author + role/company + optional avatar + optional star rating. Three layouts (uniform cards grid, centered quote-stack, CSS masonry). `featured` testimonials get a ring accent. Pairs naturally with the `testimonials` backend slice (Convex queries) but has zero coupling — pass any item array.",
+      "source": "rahman-resources",
+      "slicePath": "frontend/slices/testimonials-grid",
+      "convexPaths": [],
+      "npm": [
+        "lucide-react@^0.400.0"
+      ],
+      "shadcn": [
+        "avatar",
+        "button",
+        "card"
+      ],
+      "env": [],
+      "peers": [
+        {
+          "slug": "testimonials",
+          "range": "^0.1",
+          "reason": "Optional — pair with backend testimonials slice for full admin CRUD + storage."
+        }
+      ],
+      "providers": [],
+      "tags": [
+        "ui",
+        "testimonials",
+        "section",
+        "marketing",
+        "social-proof",
+        "saas"
+      ],
+      "agentRecipe": "Run `npx rr add testimonials-grid`. <TestimonialsGridSection items title subtitle columns layout align /> — only `items` required. Each item: `{ id, quote, author, role?, company?, avatar?, rating?, featured? }`. `layout=\"quote-stack\"` renders a centered no-card scroll for editorial sites. `layout=\"masonry\"` uses CSS columns for variable-height quotes."
+    },
+    {
+      "slug": "blog-section",
+      "title": "Blog Section",
+      "category": "ui",
+      "kind": "ui",
+      "version": "0.1.0",
+      "description": "Canonical blog list + detail section. <BlogListSection> renders 3 layouts (cards grid, minimal list, featured-split with hero + side rail). <BlogPostView> renders the single-post page with cover + meta + paragraph-split body. Both pass through `hrefFor`/`backHref` so each template controls routing — single SSOT for /blog and /blog/[slug] across all templates.",
+      "source": "rahman-resources",
+      "slicePath": "frontend/slices/blog-section",
+      "convexPaths": [],
+      "npm": [
+        "lucide-react@^0.400.0"
+      ],
+      "shadcn": [
+        "badge",
+        "button",
+        "card",
+        "separator"
+      ],
+      "env": [],
+      "peers": [
+        {
+          "slug": "mdx-blog",
+          "range": "^0.1",
+          "reason": "Optional — pair with mdx-blog backend slice for MDX-rendered posts."
+        }
+      ],
+      "providers": [],
+      "tags": [
+        "ui",
+        "blog",
+        "section",
+        "marketing",
+        "content",
+        "list",
+        "detail"
+      ],
+      "agentRecipe": "Run `npx rr add blog-section`. <BlogListSection posts hrefFor title columns layout limit /> for /blog — `hrefFor(post)` returns the per-post URL. <BlogPostView post backHref renderBody /> for /blog/[slug] — `renderBody` defaults to paragraph-split on `\\n\\n` (swap for an MDX renderer if you use mdx-blog)."
+    },
+    {
+      "slug": "changelog-feed",
+      "title": "Changelog Feed",
+      "category": "ui",
+      "kind": "ui",
+      "version": "0.1.0",
+      "description": "Canonical /changelog or /whats-new section. Entries support 5 kinds (feature/improvement/fix/chore/breaking) with color-coded badges. Three layouts (timeline with date-rail, large cards, minimal list). Optional `limit` for \"Recent updates\" excerpts on home pages. Optional `groups` per entry for sub-sectioned bullet lists.",
+      "source": "rahman-resources",
+      "slicePath": "frontend/slices/changelog-feed",
+      "convexPaths": [],
+      "npm": [],
+      "shadcn": [
+        "badge",
+        "card",
+        "separator"
+      ],
+      "env": [],
+      "peers": [],
+      "providers": [],
+      "tags": [
+        "ui",
+        "changelog",
+        "section",
+        "saas",
+        "release-notes",
+        "marketing"
+      ],
+      "agentRecipe": "Run `npx rr add changelog-feed`. <ChangelogFeedSection entries title subtitle layout sortDescending limit /> — only `entries` required. Each entry: `{ id, version, date, kind, title, body, bullets?, groups? }`. `layout=\"timeline\"` adds a left date-rail; `layout=\"list\"` is the most compact. Pass `limit={3}` on home pages to show recent releases."
+    },
+    {
+      "slug": "portfolio-section",
+      "title": "Portfolio Section",
+      "category": "ui",
+      "kind": "ui",
+      "version": "0.1.0",
+      "description": "Canonical portfolio list + detail section. <PortfolioListSection> renders 3 layouts (uniform 16:9 grid, CSS masonry, asymmetric with featured hero). <PortfolioDetailView> renders title + meta + cover + body + gallery + external link + related items. Both pass through `hrefFor`/`backHref` so each template controls routing — single SSOT for /portfolio and /portfolio/[slug] across agency-studio and personal-brand.",
+      "source": "rahman-resources",
+      "slicePath": "frontend/slices/portfolio-section",
+      "convexPaths": [],
+      "npm": [
+        "lucide-react@^0.400.0"
+      ],
+      "shadcn": [
+        "badge",
+        "button",
+        "card",
+        "separator"
+      ],
+      "env": [],
+      "peers": [],
+      "providers": [],
+      "tags": [
+        "ui",
+        "portfolio",
+        "section",
+        "marketing",
+        "case-study",
+        "list",
+        "detail"
+      ],
+      "agentRecipe": "Run `npx rr add portfolio-section`. <PortfolioListSection items hrefFor title columns layout limit /> for /portfolio — each item `{ id, slug, title, summary?, year?, client?, role?, tags?, cover: {src,alt}, gallery?, link? }`. <PortfolioDetailView item backHref renderBody related hrefForRelated /> for /portfolio/[slug] — `renderBody` defaults to paragraph split; override for project-specific layouts (problem/approach/result, brief/outcome, etc)."
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rahman-resources",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Rahman Resources (rr) — shadcn-style installer for vertical slices. `npx resources add <slug>` copies slice into your project's `slices/<slug>/`. You own the files.",
   "type": "module",
   "license": "MIT",