@nextsparkjs/theme-blog 0.1.0-beta.189 → 0.1.0-beta.190

package/components/ExportPostsButton.tsx

@@ -4,6 +4,7 @@ import { useState } from 'react'
 import { Button } from '@nextsparkjs/core/components/ui/button'
 import { Download, Loader2 } from 'lucide-react'
 import { useToast } from '@nextsparkjs/core/hooks/useToast'
+import { withBasePath } from '@nextsparkjs/core/lib/base-path'
 
 interface ExportPostsButtonProps {
   className?: string
@@ -17,7 +18,7 @@ export function ExportPostsButton({ className }: ExportPostsButtonProps) {
     setIsExporting(true)
     
     try {
-      const response = await fetch('/api/v1/posts?limit=1000', {
+      const response = await fetch(withBasePath('/api/v1/posts?limit=1000'), {
         method: 'GET',
         headers: {
           'Content-Type': 'application/json',

package/components/ImportPostsDialog.tsx

@@ -16,6 +16,7 @@ import { Badge } from '@nextsparkjs/core/components/ui/badge'
 import { ScrollArea } from '@nextsparkjs/core/components/ui/scroll-area'
 import { Upload, FileJson, AlertCircle, CheckCircle2, Loader2 } from 'lucide-react'
 import { useToast } from '@nextsparkjs/core/hooks/useToast'
+import { withBasePath } from '@nextsparkjs/core/lib/base-path'
 
 interface PostImport {
   title: string
@@ -108,7 +109,7 @@ export function ImportPostsDialog({ className, onImportComplete }: ImportPostsDi
       const post = posts[i]
       
       try {
-        const response = await fetch('/api/v1/posts', {
+        const response = await fetch(withBasePath('/api/v1/posts'), {
           method: 'POST',
           headers: {
             'Content-Type': 'application/json',

package/components/editor/FeaturedImageUpload.tsx

@@ -12,6 +12,7 @@ import NextImage from 'next/image'
 import { X, Upload, Image as ImageIcon } from 'lucide-react'
 import { Button } from '@nextsparkjs/core/components/ui/button'
 import { cn } from '@nextsparkjs/core/lib/utils'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface FeaturedImageUploadProps {
   value: string // URL string
@@ -111,7 +112,7 @@ export function FeaturedImageUpload({
         // Image Preview
         <div className="relative aspect-video rounded-lg overflow-hidden border border-border bg-muted" data-cy="featured-image-preview">
           <NextImage
-            src={value}
+            src={withBasePathIfInApp(value)}
             alt="Featured image preview"
             fill
             className="object-cover"

package/components/public/AuthorBio.tsx

@@ -9,6 +9,7 @@
 import Image from 'next/image'
 import Link from 'next/link'
 import { Twitter, Github, Linkedin, Globe, User } from 'lucide-react'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface SocialLink {
   type: 'twitter' | 'github' | 'linkedin' | 'website'
@@ -43,7 +44,7 @@ export function AuthorBio({
       <div data-cy="author-bio-avatar" className="flex-shrink-0">
         {avatar ? (
           <Image
-            src={avatar}
+            src={withBasePathIfInApp(avatar)}
             alt={name}
             width={64}
             height={64}
@@ -84,7 +85,7 @@ export function AuthorBio({
               return (
                 <a
                   key={link.type}
-                  href={link.url}
+                  href={withBasePathIfInApp(link.url)}
                   data-cy={`author-bio-social-${link.type}`}
                   target="_blank"
                   rel="noopener noreferrer"

package/components/public/AuthorCard.tsx

@@ -11,6 +11,7 @@ import Link from 'next/link'
 import Image from 'next/image'
 import { User } from 'lucide-react'
 import { cn } from '@nextsparkjs/core/lib/utils'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface AuthorCardProps {
   username: string
@@ -48,7 +49,7 @@ export function AuthorCard({
         <div data-cy={`author-card-avatar-${username}`} className="flex-shrink-0">
           {avatar ? (
             <Image
-              src={avatar}
+              src={withBasePathIfInApp(avatar)}
               alt={name}
               width={48}
               height={48}
@@ -89,7 +90,7 @@ export function AuthorCard({
       <div data-cy={`author-card-avatar-${username}`} className="flex justify-center mb-4">
         {avatar ? (
           <Image
-            src={avatar}
+            src={withBasePathIfInApp(avatar)}
             alt={name}
             width={96}
             height={96}

package/components/public/BlogFooter.tsx

@@ -8,6 +8,7 @@
 
 import Link from 'next/link'
 import { Github, Twitter, Linkedin, Mail, Heart } from 'lucide-react'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface SocialLink {
   name: string
@@ -117,7 +118,7 @@ export function BlogFooter({
                       return (
                         <a
                           key={link.name}
-                          href={link.href}
+                          href={withBasePathIfInApp(link.href)}
                           data-cy={`blog-footer-social-${link.icon}`}
                           target="_blank"
                           rel="noopener noreferrer"

package/components/public/PostCard.tsx

@@ -11,6 +11,7 @@ import Link from 'next/link'
 import Image from 'next/image'
 import { Calendar, Clock, User } from 'lucide-react'
 import { cn } from '@nextsparkjs/core/lib/utils'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface PostCardProps {
   id: string
@@ -73,7 +74,7 @@ export function PostCard({
         <div data-cy={`post-card-image-${id}`} className="aspect-[21/9] relative overflow-hidden">
           {featuredImage ? (
             <Image
-              src={featuredImage}
+              src={withBasePathIfInApp(featuredImage)}
               alt={title}
               fill
               className="object-cover transition-transform duration-500 group-hover:scale-105"
@@ -115,7 +116,7 @@ export function PostCard({
               <Link href={authorUrl} data-cy={`post-card-author-${id}`} className="flex items-center gap-2 hover:text-foreground transition-colors">
                 {authorAvatar ? (
                   <Image
-                    src={authorAvatar}
+                    src={withBasePathIfInApp(authorAvatar)}
                     alt={authorName}
                     width={24}
                     height={24}
@@ -132,7 +133,7 @@ export function PostCard({
               <div data-cy={`post-card-author-${id}`} className="flex items-center gap-2">
                 {authorAvatar ? (
                   <Image
-                    src={authorAvatar}
+                    src={withBasePathIfInApp(authorAvatar)}
                     alt={authorName}
                     width={24}
                     height={24}
@@ -174,7 +175,7 @@ export function PostCard({
         <div data-cy={`post-card-image-${id}`} className="flex-shrink-0 w-24 h-24 relative overflow-hidden rounded-md">
           {featuredImage ? (
             <Image
-              src={featuredImage}
+              src={withBasePathIfInApp(featuredImage)}
               alt={title}
               fill
               className="object-cover"
@@ -216,7 +217,7 @@ export function PostCard({
       <div data-cy={`post-card-image-${id}`} className="aspect-[16/10] relative overflow-hidden">
         {featuredImage ? (
           <Image
-            src={featuredImage}
+            src={withBasePathIfInApp(featuredImage)}
             alt={title}
             fill
             className="object-cover transition-transform duration-500 group-hover:scale-105"
@@ -256,7 +257,7 @@ export function PostCard({
             <Link href={authorUrl} data-cy={`post-card-author-${id}`} className="flex items-center gap-2 hover:text-foreground transition-colors">
               {authorAvatar ? (
                 <Image
-                  src={authorAvatar}
+                  src={withBasePathIfInApp(authorAvatar)}
                   alt={authorName}
                   width={20}
                   height={20}
@@ -273,7 +274,7 @@ export function PostCard({
             <div data-cy={`post-card-author-${id}`} className="flex items-center gap-2">
               {authorAvatar ? (
                 <Image
-                  src={authorAvatar}
+                  src={withBasePathIfInApp(authorAvatar)}
                   alt={authorName}
                   width={20}
                   height={20}

package/components/public/RelatedPosts.tsx

@@ -9,6 +9,7 @@
 import Link from 'next/link'
 import Image from 'next/image'
 import { Clock } from 'lucide-react'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface RelatedPost {
   id: string
@@ -45,7 +46,7 @@ export function RelatedPosts({
             <div data-cy={`related-post-image-${post.id}`} className="aspect-[16/9] relative overflow-hidden">
               {post.featuredImage ? (
                 <Image
-                  src={post.featuredImage}
+                  src={withBasePathIfInApp(post.featuredImage)}
                   alt={post.title}
                   fill
                   className="object-cover transition-transform duration-300 group-hover:scale-105"

package/config/app.config.ts

@@ -100,25 +100,19 @@ export const APP_CONFIG_OVERRIDES = {
   // =============================================================================
   docs: {
     enabled: true,
-    public: true,
+    publicAccess: true,
     searchEnabled: true,
     breadcrumbs: true,
-    theme: {
+    public: {
       enabled: true,
       open: true,
       label: "Blog Theme",
     },
-    plugins: {
-      enabled: false,
-      open: false,
-      label: "Plugins",
-    },
-    core: {
+    superadmin: {
       enabled: true,
       open: false,
-      label: "Core",
+      label: "Admin Docs",
     },
-    showPluginsDocsInProd: false,
   },
 
   // =============================================================================

package/migrations/090_billing_sample_data.sql

@@ -0,0 +1,99 @@
+-- Migration: 090_billing_sample_data.sql
+-- Description: Sample billing plans for the blog theme (free, pro, enterprise)
+-- Theme: blog
+-- Phase: Theme sample data - runs before 999_theme_sample_data.sql, whose
+--        subscriptions reference these plans by slug.
+--
+-- Mirrors themes/blog/config/billing.config.ts (slugs, prices, features,
+-- limits) so the seeded plans match what the app's billing config declares.
+
+-- ============================================
+-- SAMPLE PLANS
+-- ============================================
+
+-- Plan: Free
+INSERT INTO public."plans" (
+  id,
+  slug,
+  name,
+  description,
+  type,
+  visibility,
+  "priceMonthly",
+  "priceYearly",
+  "trialDays",
+  features,
+  limits,
+  "sortOrder"
+) VALUES (
+  'plan_blog_free',
+  'free',
+  'Free',
+  'Free plan to get started',
+  'free',
+  'public',
+  0,
+  0,
+  0,
+  '["basic_analytics"]'::jsonb,
+  '{"posts": 10, "monthly_views": 10000, "storage_gb": 1, "authors": 1}'::jsonb,
+  1
+) ON CONFLICT (slug) DO NOTHING;
+
+-- Plan: Pro
+INSERT INTO public."plans" (
+  id,
+  slug,
+  name,
+  description,
+  type,
+  visibility,
+  "priceMonthly",
+  "priceYearly",
+  "trialDays",
+  features,
+  limits,
+  "sortOrder"
+) VALUES (
+  'plan_blog_pro',
+  'pro',
+  'Pro',
+  'Professional plan for bloggers',
+  'paid',
+  'public',
+  2900,
+  29000,
+  14,
+  '["basic_analytics", "custom_domain", "advanced_seo"]'::jsonb,
+  '{"posts": -1, "monthly_views": 100000, "storage_gb": 10, "authors": 5}'::jsonb,
+  2
+) ON CONFLICT (slug) DO NOTHING;
+
+-- Plan: Enterprise
+INSERT INTO public."plans" (
+  id,
+  slug,
+  name,
+  description,
+  type,
+  visibility,
+  "priceMonthly",
+  "priceYearly",
+  "trialDays",
+  features,
+  limits,
+  "sortOrder"
+) VALUES (
+  'plan_blog_enterprise',
+  'enterprise',
+  'Enterprise',
+  'Custom enterprise plan with unlimited features',
+  'enterprise',
+  'hidden',
+  NULL,
+  NULL,
+  30,
+  '["*"]'::jsonb,
+  '{"posts": -1, "monthly_views": -1, "storage_gb": -1, "authors": -1}'::jsonb,
+  3
+) ON CONFLICT (slug) DO NOTHING;

package/migrations/999_theme_sample_data.sql

@@ -662,15 +662,15 @@ INSERT INTO public."subscriptions" (
   "externalSubscriptionId", "externalCustomerId", "createdAt"
 ) VALUES
   -- Marcos Tech → Pro Plan $29/mo (active, monthly)
-  ('sub-blog-marcos', 'team-blog-marcos', 'usr-blog-marcos', 'plan_pro', 'active',
+  ('sub-blog-marcos', 'team-blog-marcos', 'usr-blog-marcos', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'active',
    NOW() - INTERVAL '30 days', NOW() + INTERVAL '30 days', 'monthly', 'stripe',
    'sub_stripe_marcos', 'cus_marcos', NOW() - INTERVAL '6 months'),
   -- Lucia Lifestyle → Pro Plan $29/mo (active, monthly)
-  ('sub-blog-lucia', 'team-blog-lucia', 'usr-blog-lucia', 'plan_pro', 'active',
+  ('sub-blog-lucia', 'team-blog-lucia', 'usr-blog-lucia', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'active',
    NOW() - INTERVAL '15 days', NOW() + INTERVAL '15 days', 'monthly', 'stripe',
    'sub_stripe_lucia', 'cus_lucia', NOW() - INTERVAL '5 months'),
   -- Carlos Finance → Pro Plan (trialing, monthly)
-  ('sub-blog-carlos', 'team-blog-carlos', 'usr-blog-carlos', 'plan_pro', 'trialing',
+  ('sub-blog-carlos', 'team-blog-carlos', 'usr-blog-carlos', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'trialing',
    NOW(), NOW() + INTERVAL '14 days', 'monthly', NULL, NULL, NULL, NOW() - INTERVAL '4 months')
 ON CONFLICT (id) DO NOTHING;
 
@@ -843,64 +843,64 @@ INSERT INTO public."subscriptions" (
   "createdAt", "canceledAt", "cancelAtPeriodEnd", metadata
 ) VALUES
   -- 1. Diana Design - Pro Monthly ACTIVE (8 months customer)
-  ('sub-blog-diana', 'team-blog-diana', 'usr-blog-diana', 'plan_pro', 'active',
+  ('sub-blog-diana', 'team-blog-diana', 'usr-blog-diana', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'active',
    NOW() - INTERVAL '25 days', NOW() + INTERVAL '5 days', 'monthly',
    'stripe', 'sub_stripe_diana', 'cus_diana',
    NOW() - INTERVAL '8 months', NULL, false, '{}'::jsonb),
 
   -- 2. Elena Eco - Pro Monthly ACTIVE (7 months customer)
-  ('sub-blog-elena', 'team-blog-elena', 'usr-blog-elena', 'plan_pro', 'active',
+  ('sub-blog-elena', 'team-blog-elena', 'usr-blog-elena', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'active',
    NOW() - INTERVAL '20 days', NOW() + INTERVAL '10 days', 'monthly',
    'stripe', 'sub_stripe_elena', 'cus_elena',
    NOW() - INTERVAL '7 months', NULL, false, '{}'::jsonb),
 
   -- 3. Felix Fitness - Pro Yearly ACTIVE (14 months = 2nd year)
-  ('sub-blog-felix', 'team-blog-felix', 'usr-blog-felix', 'plan_pro', 'active',
+  ('sub-blog-felix', 'team-blog-felix', 'usr-blog-felix', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'active',
    NOW() - INTERVAL '60 days', NOW() + INTERVAL '305 days', 'yearly',
    'stripe', 'sub_stripe_felix', 'cus_felix',
    NOW() - INTERVAL '14 months', NULL, false, '{}'::jsonb),
 
   -- 4. Gloria Gourmet - Pro Yearly ACTIVE (12 months)
-  ('sub-blog-gloria', 'team-blog-gloria', 'usr-blog-gloria', 'plan_pro', 'active',
+  ('sub-blog-gloria', 'team-blog-gloria', 'usr-blog-gloria', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'active',
    NOW() - INTERVAL '30 days', NOW() + INTERVAL '335 days', 'yearly',
    'stripe', 'sub_stripe_gloria', 'cus_gloria',
    NOW() - INTERVAL '12 months', NULL, false, '{}'::jsonb),
 
   -- 5. Hugo Health - Pro Monthly ACTIVE (6 months customer)
-  ('sub-blog-hugo', 'team-blog-hugo', 'usr-blog-hugo', 'plan_pro', 'active',
+  ('sub-blog-hugo', 'team-blog-hugo', 'usr-blog-hugo', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'active',
    NOW() - INTERVAL '18 days', NOW() + INTERVAL '12 days', 'monthly',
    'stripe', 'sub_stripe_hugo', 'cus_hugo',
    NOW() - INTERVAL '6 months', NULL, false, '{}'::jsonb),
 
   -- 6. Iris Inspire - Pro Monthly PAST_DUE (failed payment)
-  ('sub-blog-iris', 'team-blog-iris', 'usr-blog-iris', 'plan_pro', 'past_due',
+  ('sub-blog-iris', 'team-blog-iris', 'usr-blog-iris', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'past_due',
    NOW() - INTERVAL '35 days', NOW() - INTERVAL '5 days', 'monthly',
    'stripe', 'sub_stripe_iris', 'cus_iris',
    NOW() - INTERVAL '5 months', NULL, false,
    '{"lastPaymentAttempt": "failed", "retryCount": 2}'::jsonb),
 
   -- 7. Jorge Journey - Pro Monthly CANCELED (voluntary - user decided to cancel)
-  ('sub-blog-jorge', 'team-blog-jorge', 'usr-blog-jorge', 'plan_pro', 'canceled',
+  ('sub-blog-jorge', 'team-blog-jorge', 'usr-blog-jorge', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'canceled',
    NOW() - INTERVAL '45 days', NOW() - INTERVAL '15 days', 'monthly',
    'stripe', 'sub_stripe_jorge', 'cus_jorge',
    NOW() - INTERVAL '9 months', NOW() - INTERVAL '15 days', false,
    '{"cancelReason": "voluntary", "canceledBy": "user", "feedback": "taking a break"}'::jsonb),
 
   -- 8. Karen Kitchen - Pro Yearly CANCELED (payment failed 4 times)
-  ('sub-blog-karen', 'team-blog-karen', 'usr-blog-karen', 'plan_pro', 'canceled',
+  ('sub-blog-karen', 'team-blog-karen', 'usr-blog-karen', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'canceled',
    NOW() - INTERVAL '400 days', NOW() - INTERVAL '35 days', 'yearly',
    'stripe', 'sub_stripe_karen', 'cus_karen',
    NOW() - INTERVAL '15 months', NOW() - INTERVAL '35 days', false,
    '{"cancelReason": "payment_failed", "failedAttempts": 4, "lastCardEnding": "4242"}'::jsonb),
 
   -- 9. Leo Learn - Free Plan ACTIVE (no billing)
-  ('sub-blog-leo', 'team-blog-leo', 'usr-blog-leo', 'plan_free', 'active',
+  ('sub-blog-leo', 'team-blog-leo', 'usr-blog-leo', (SELECT id FROM public."plans" WHERE slug = 'free'), 'active',
    NOW() - INTERVAL '2 months', NOW() + INTERVAL '100 years', 'monthly',
    NULL, NULL, NULL,
    NOW() - INTERVAL '2 months', NULL, false, '{}'::jsonb),
 
   -- 10. Maria Music - Pro Monthly TRIALING (5 days in)
-  ('sub-blog-maria', 'team-blog-maria', 'usr-blog-maria', 'plan_pro', 'trialing',
+  ('sub-blog-maria', 'team-blog-maria', 'usr-blog-maria', (SELECT id FROM public."plans" WHERE slug = 'pro'), 'trialing',
    NOW() - INTERVAL '5 days', NOW() + INTERVAL '25 days', 'monthly',
    NULL, NULL, NULL,
    NOW() - INTERVAL '5 days', NULL, false, '{}'::jsonb)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/theme-blog",
-  "version": "0.1.0-beta.189",
+  "version": "0.1.0-beta.190",
   "private": false,
   "type": "module",
   "main": "./config/theme.config.ts",
@@ -14,7 +14,7 @@
     "@nextsparkjs/core": ">=0.1.0-0",
     "@nextsparkjs/testing": ">=0.1.0-0",
     "lucide-react": "^0.539.0",
-    "next": "^15.0.0",
+    "next": "^15.0.0 || ^16.0.0",
     "next-intl": "^4.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",

package/templates/(public)/author/[username]/page.tsx

@@ -13,6 +13,7 @@ import Image from 'next/image'
 import { Twitter, Linkedin, Globe, User } from 'lucide-react'
 import { PostCard } from '@/themes/blog/components/public/PostCard'
 import { cn } from '@nextsparkjs/core/lib/utils'
+import { withBasePath, withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface Author {
   id: string
@@ -60,7 +61,7 @@ export default function AuthorPage({ params }: PageProps) {
         setLoading(true)
         setError(null)
 
-        const response = await fetch(`/api/v1/theme/blog/authors/${username}`, {
+        const response = await fetch(withBasePath(`/api/v1/theme/blog/authors/${username}`), {
           method: 'GET',
           headers: {
             'Content-Type': 'application/json',
@@ -137,7 +138,7 @@ export default function AuthorPage({ params }: PageProps) {
           <div className="flex-shrink-0">
             {author.image ? (
               <Image
-                src={author.image}
+                src={withBasePathIfInApp(author.image)}
                 alt={author.name}
                 width={128}
                 height={128}
@@ -165,7 +166,7 @@ export default function AuthorPage({ params }: PageProps) {
             <div className="flex items-center gap-4">
               {author.socialTwitter && (
                 <a
-                  href={author.socialTwitter}
+                  href={withBasePathIfInApp(author.socialTwitter)}
                   target="_blank"
                   rel="noopener noreferrer"
                   className="flex items-center gap-2 text-sm text-muted-foreground hover:text-foreground transition-colors"
@@ -176,7 +177,7 @@ export default function AuthorPage({ params }: PageProps) {
               )}
               {author.socialLinkedin && (
                 <a
-                  href={author.socialLinkedin}
+                  href={withBasePathIfInApp(author.socialLinkedin)}
                   target="_blank"
                   rel="noopener noreferrer"
                   className="flex items-center gap-2 text-sm text-muted-foreground hover:text-foreground transition-colors"
@@ -187,7 +188,7 @@ export default function AuthorPage({ params }: PageProps) {
               )}
               {author.socialWebsite && (
                 <a
-                  href={author.socialWebsite}
+                  href={withBasePathIfInApp(author.socialWebsite)}
                   target="_blank"
                   rel="noopener noreferrer"
                   className="flex items-center gap-2 text-sm text-muted-foreground hover:text-foreground transition-colors"

package/templates/(public)/authors/page.tsx

@@ -10,6 +10,7 @@ import { useState, useEffect } from 'react'
 import Link from 'next/link'
 import Image from 'next/image'
 import { User } from 'lucide-react'
+import { withBasePath, withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface Author {
   id: string
@@ -31,7 +32,7 @@ export default function AuthorsPage() {
         setLoading(true)
         setError(null)
 
-        const response = await fetch('/api/v1/theme/blog/authors', {
+        const response = await fetch(withBasePath('/api/v1/theme/blog/authors'), {
           method: 'GET',
           headers: {
             'Content-Type': 'application/json',
@@ -115,7 +116,7 @@ export default function AuthorsPage() {
                 <div className="flex justify-center mb-4">
                   {author.image ? (
                     <Image
-                      src={author.image}
+                      src={withBasePathIfInApp(author.image)}
                       alt={author.name}
                       width={80}
                       height={80}

package/templates/(public)/page.tsx

@@ -14,6 +14,7 @@ import { useTranslations } from 'next-intl'
 import { PostCard } from '@/themes/blog/components/public/PostCard'
 import { cn } from '@nextsparkjs/core/lib/utils'
 import { Loader2 } from 'lucide-react'
+import { withBasePath } from '@nextsparkjs/core/lib/base-path'
 
 interface Post {
   id: string
@@ -65,7 +66,7 @@ export default function BlogHomePage() {
 
       // Fetch published posts from ALL authors via public endpoint
       // This endpoint does not require authentication and aggregates posts cross-team
-      const response = await fetch('/api/v1/theme/blog/posts/public?limit=20', {
+      const response = await fetch(withBasePath('/api/v1/theme/blog/posts/public?limit=20'), {
         method: 'GET',
         headers: {
           'Content-Type': 'application/json',

package/templates/(public)/posts/[slug]/page.tsx

@@ -17,6 +17,7 @@ import { ReadingProgress } from '@/themes/blog/components/public/ReadingProgress
 import { AuthorBio } from '@/themes/blog/components/public/AuthorBio'
 import { RelatedPosts } from '@/themes/blog/components/public/RelatedPosts'
 import { Button } from '@nextsparkjs/core/components/ui/button'
+import { withBasePath, withBasePathInHtml, withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface Post {
   id: string
@@ -58,7 +59,7 @@ async function fetchPost(identifier: string): Promise<Post | null> {
   try {
     const headers = buildHeaders()
 
-    const byIdResponse = await fetch(`/api/v1/posts?ids=${encodeURIComponent(identifier)}&status=published&limit=1`, {
+    const byIdResponse = await fetch(withBasePath(`/api/v1/posts?ids=${encodeURIComponent(identifier)}&status=published&limit=1`), {
       credentials: 'include',
       headers,
     })
@@ -70,7 +71,7 @@ async function fetchPost(identifier: string): Promise<Post | null> {
       }
     }
 
-    const bySlugResponse = await fetch(`/api/v1/posts?slug=${encodeURIComponent(identifier)}&status=published&limit=1`, {
+    const bySlugResponse = await fetch(withBasePath(`/api/v1/posts?slug=${encodeURIComponent(identifier)}&status=published&limit=1`), {
       credentials: 'include',
       headers,
     })
@@ -146,7 +147,7 @@ async function fetchRelatedPosts(currentPostId: string): Promise<RelatedPost[]>
     const headers = buildHeaders()
 
     // Fetch latest published posts
-    const response = await fetch('/api/v1/posts?status=published&limit=4&sortBy=publishedAt&sortOrder=desc', {
+    const response = await fetch(withBasePath('/api/v1/posts?status=published&limit=4&sortBy=publishedAt&sortOrder=desc'), {
       credentials: 'include',
       headers,
     })
@@ -282,7 +283,7 @@ export default function PostPage({ params }: PageProps) {
           <figure className="mb-12">
             <div className="aspect-[21/9] relative overflow-hidden rounded-xl">
               <Image
-                src={post.featuredImage}
+                src={withBasePathIfInApp(post.featuredImage)}
                 alt={post.title}
                 fill
                 className="object-cover"
@@ -295,7 +296,7 @@ export default function PostPage({ params }: PageProps) {
 
         {/* Article Content */}
         <div className="article-content">
-          <div dangerouslySetInnerHTML={{ __html: sanitizePostHtml(renderContent(post.content)) }} />
+          <div dangerouslySetInnerHTML={{ __html: withBasePathInHtml(sanitizePostHtml(renderContent(post.content))) }} />
         </div>
 
         {/* Divider */}

package/templates/dashboard/(main)/page.tsx

@@ -29,6 +29,7 @@ import {
   Eye,
   MoreHorizontal
 } from 'lucide-react'
+import { withBasePath } from '@nextsparkjs/core/lib/base-path'
 
 interface PostStats {
   total: number
@@ -65,7 +66,7 @@ async function fetchPosts(): Promise<{ stats: PostStats; recent: RecentPost[] }>
     const headers = buildHeaders()
 
     // Fetch all posts to get stats
-    const response = await fetch('/api/v1/posts?limit=100&sortBy=updatedAt&sortOrder=desc', {
+    const response = await fetch(withBasePath('/api/v1/posts?limit=100&sortBy=updatedAt&sortOrder=desc'), {
       credentials: 'include',
       headers,
     })

package/templates/dashboard/(main)/posts/[id]/edit/page.tsx

@@ -39,6 +39,7 @@ import {
 import { Switch } from '@nextsparkjs/core/components/ui/switch'
 import { WysiwygEditor } from '@/themes/blog/components/editor/WysiwygEditor'
 import { FeaturedImageUpload } from '@/themes/blog/components/editor/FeaturedImageUpload'
+import { withBasePath } from '@nextsparkjs/core/lib/base-path'
 
 interface PostData {
   id: string
@@ -102,7 +103,7 @@ export default function EditPostPage({ params }: PageProps) {
     async function fetchPost() {
       try {
         const headers = buildHeaders()
-        const response = await fetch(`/api/v1/posts/${id}`, {
+        const response = await fetch(withBasePath(`/api/v1/posts/${id}`), {
           credentials: 'include',
           headers,
         })
@@ -178,7 +179,7 @@ export default function EditPostPage({ params }: PageProps) {
 
     try {
       const headers = buildHeaders()
-      const response = await fetch(`/api/v1/posts/${id}`, {
+      const response = await fetch(withBasePath(`/api/v1/posts/${id}`), {
         method: 'PATCH',
         headers,
         credentials: 'include',
@@ -232,7 +233,7 @@ export default function EditPostPage({ params }: PageProps) {
 
     try {
       const headers = buildHeaders()
-      const response = await fetch(`/api/v1/posts/${id}`, {
+      const response = await fetch(withBasePath(`/api/v1/posts/${id}`), {
         method: 'DELETE',
         headers,
         credentials: 'include',

package/templates/dashboard/(main)/posts/create/page.tsx

@@ -29,6 +29,7 @@ import { Card, CardContent, CardHeader, CardTitle } from '@nextsparkjs/core/comp
 import { Switch } from '@nextsparkjs/core/components/ui/switch'
 import { WysiwygEditor } from '@/themes/blog/components/editor/WysiwygEditor'
 import { FeaturedImageUpload } from '@/themes/blog/components/editor/FeaturedImageUpload'
+import { withBasePath } from '@nextsparkjs/core/lib/base-path'
 
 interface PostData {
   title: string
@@ -122,7 +123,7 @@ export default function CreatePostPage() {
 
     try {
       const headers = buildHeaders()
-      const response = await fetch('/api/v1/posts', {
+      const response = await fetch(withBasePath('/api/v1/posts'), {
         method: 'POST',
         headers,
         credentials: 'include',

package/templates/dashboard/(main)/posts/page.tsx

@@ -63,6 +63,7 @@ import {
   Send,
   ImageIcon,
 } from 'lucide-react'
+import { withBasePath, withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 interface Post {
   id: string
@@ -174,7 +175,7 @@ export default function PostsListPage() {
         sortOrder,
       })
 
-      const response = await fetch(`/api/v1/posts?${params}`, {
+      const response = await fetch(withBasePath(`/api/v1/posts?${params}`), {
         credentials: 'include',
         headers,
       })
@@ -246,7 +247,7 @@ export default function PostsListPage() {
     setActionLoading(post.id)
     try {
       const headers = buildHeaders()
-      const response = await fetch(`/api/v1/posts/${post.id}`, {
+      const response = await fetch(withBasePath(`/api/v1/posts/${post.id}`), {
         method: 'PATCH',
         headers,
         credentials: 'include',
@@ -269,7 +270,7 @@ export default function PostsListPage() {
     setActionLoading(post.id)
     try {
       const headers = buildHeaders()
-      const response = await fetch(`/api/v1/posts/${post.id}`, {
+      const response = await fetch(withBasePath(`/api/v1/posts/${post.id}`), {
         method: 'PATCH',
         headers,
         credentials: 'include',
@@ -291,7 +292,7 @@ export default function PostsListPage() {
     setActionLoading(postToDelete.id)
     try {
       const headers = buildHeaders()
-      const response = await fetch(`/api/v1/posts/${postToDelete.id}`, {
+      const response = await fetch(withBasePath(`/api/v1/posts/${postToDelete.id}`), {
         method: 'DELETE',
         headers,
         credentials: 'include',
@@ -555,7 +556,7 @@ export default function PostsListPage() {
                           <div className="hidden sm:block flex-shrink-0 w-16 h-12 rounded overflow-hidden bg-muted">
                             {post.featuredImage ? (
                               <Image
-                                src={post.featuredImage}
+                                src={withBasePathIfInApp(post.featuredImage)}
                                 alt=""
                                 width={64}
                                 height={48}
@@ -690,7 +691,7 @@ export default function PostsListPage() {
                 <div className="aspect-video relative bg-muted">
                   {post.featuredImage ? (
                     <Image
-                      src={post.featuredImage}
+                      src={withBasePathIfInApp(post.featuredImage)}
                       alt=""
                       fill
                       className="object-cover"