@lukoweb/apitogo 0.1.55 → 0.1.56

package/dist/cli/cli.js

@@ -667,7 +667,7 @@ var init_file_exists = __esm({
 
 // src/config/validators/ModulesSchema.ts
 import { z as z3 } from "zod";
-var ModuleToggleSchema, DocsModuleSchema, LandingLinkSchema, LandingFeatureSchema, LandingCodeExampleSchema, LandingHeroSchema, LandingTickerItemSchema, LandingTickerSchema, LandingTrustSchema, LandingApiShowcaseItemSchema, LandingApiShowcaseSchema, LandingPricingCtaSchema, LandingContentSchema, DashboardContentSchema, ProfileContentSchema, PlanTierSchema, PlansContentSchema, SubmodulePageFields, LandingModuleSchema, UserManagementModuleSchema, ApiKeysModuleSchema, PlanCatalogItemSchema, PlansModuleSchema, DashboardModuleSchema, UserPanelModuleSchema, ModulesSchema;
+var ModuleToggleSchema, DocsModuleSchema, LandingLinkSchema, LandingFeatureSchema, LandingCodeExampleSchema, LandingHeroSchema, LandingFeaturesSectionSchema, LandingTickerItemSchema, LandingTickerSchema, LandingTrustSchema, LandingApiShowcaseItemSchema, LandingApiShowcaseSchema, LandingPricingCtaSchema, LandingContentSchema, DashboardContentSchema, ProfileContentSchema, PlanTierSchema, PlansContentSchema, SubmodulePageFields, LandingModuleSchema, UserManagementModuleSchema, ApiKeysModuleSchema, PlanCatalogItemSchema, PlansModuleSchema, DashboardModuleSchema, UserPanelModuleSchema, ModulesSchema;
 var init_ModulesSchema = __esm({
   "src/config/validators/ModulesSchema.ts"() {
     ModuleToggleSchema = z3.object({
@@ -708,12 +708,18 @@ var init_ModulesSchema = __esm({
     }).optional();
     LandingHeroSchema = z3.object({
       title: z3.string().optional(),
+      titleAccent: z3.string().optional().describe("Accent-colored word or phrase shown on a new line after the title."),
       subtitle: z3.string().optional(),
       description: z3.string().optional(),
       badge: z3.string().optional(),
       highlights: z3.array(z3.string()).optional(),
       codeExample: LandingCodeExampleSchema
     }).optional();
+    LandingFeaturesSectionSchema = z3.object({
+      label: z3.string().optional(),
+      title: z3.string().optional(),
+      description: z3.string().optional()
+    }).optional();
     LandingTickerItemSchema = z3.object({
       label: z3.string(),
       value: z3.string(),
@@ -753,6 +759,7 @@ var init_ModulesSchema = __esm({
     }).optional();
     LandingContentSchema = z3.object({
       hero: LandingHeroSchema,
+      featuresSection: LandingFeaturesSectionSchema,
       features: z3.array(LandingFeatureSchema).optional(),
       primaryAction: LandingLinkSchema.optional(),
       secondaryAction: LandingLinkSchema.optional(),
@@ -799,6 +806,9 @@ var init_ModulesSchema = __esm({
       ),
       content: LandingContentSchema.describe(
         "Default landing page content when no custom component is provided."
+      ),
+      useDefaults: z3.boolean().optional().describe(
+        "When true, merge DEFAULT_LANDING_CONTENT for unset sections. When false or omitted, only configured sections are shown."
       )
     });
     UserManagementModuleSchema = ModuleToggleSchema.extend({
@@ -1032,10 +1042,160 @@ var init_local_manifest = __esm({
   }
 });
 
+// src/config/default-landing-content.ts
+var DEFAULT_LANDING_CONTENT;
+var init_default_landing_content = __esm({
+  "src/config/default-landing-content.ts"() {
+    DEFAULT_LANDING_CONTENT = {
+      hero: {
+        badge: "99.98% uptime",
+        subtitle: "Production-ready APIs, one endpoint away",
+        title: "Developer APIs that ship",
+        titleAccent: "today.",
+        description: "Documentation, interactive API reference, auth, and billing \u2014 sub-40ms responses, one API key, generous free tier.",
+        highlights: ["No credit card", "10k requests free", "SDKs for 6 languages"],
+        codeExample: {
+          filename: "example.sh",
+          language: "bash",
+          code: `$ curl https://api.example.com/v1/items \\
+  -H "Authorization: Bearer YOUR_API_KEY" \\
+  -d "limit=10"
+
+{
+  "items": [
+    { "id": "item_1", "name": "Widget", "status": "active" },
+    { "id": "item_2", "name": "Gadget", "status": "active" }
+  ]
+} // 28ms`
+        }
+      },
+      primaryAction: { label: "Get your API key", href: "/register" },
+      secondaryAction: { label: "Read the docs", href: "/introduction" },
+      ticker: {
+        items: [
+          { label: "GET", value: "/v1/items", change: "28ms" },
+          { label: "POST", value: "/v1/items", change: "34ms" },
+          { label: "GET", value: "/v1/users", change: "19ms" },
+          { label: "PATCH", value: "/v1/users/{id}", change: "41ms" },
+          { label: "GET", value: "/v1/health", change: "16ms" },
+          { label: "DELETE", value: "/v1/items/{id}", change: "22ms" },
+          { label: "GET", value: "/v1/search", change: "47ms" },
+          { label: "POST", value: "/v1/auth/token", change: "52ms" }
+        ]
+      },
+      trust: {
+        title: "Trusted by teams shipping production APIs",
+        logos: ["Acme Corp", "BuildFast", "DataFlow", "ShipKit", "DevStack", "LaunchPad"]
+      },
+      featuresSection: {
+        label: "// why us",
+        title: "Everything you need to build on your API",
+        description: "Skip the infra. We handle docs, auth, keys, and billing so you can focus on your product."
+      },
+      features: [
+        {
+          icon: "gauge",
+          title: "Sub-40ms responses",
+          description: "Edge-cached and globally distributed, so your app feels instant anywhere."
+        },
+        {
+          icon: "radio",
+          title: "Real-time streams",
+          description: "WebSocket feeds with automatic reconnection for live data and events."
+        },
+        {
+          icon: "blocks",
+          title: "Unified schema",
+          description: "One consistent API design \u2014 no per-endpoint glue code or custom adapters."
+        },
+        {
+          icon: "shield-check",
+          title: "99.98% uptime",
+          description: "Redundant infra with a public status page and an SLA on paid plans."
+        },
+        {
+          icon: "code",
+          title: "SDKs for 6 languages",
+          description: "Typed clients for JS, Python, Go, Rust, Ruby and PHP. Copy, paste, ship."
+        },
+        {
+          icon: "webhook",
+          title: "Webhooks & alerts",
+          description: "Push events and threshold alerts straight to your endpoints."
+        }
+      ],
+      apiShowcase: {
+        title: "Production APIs. One key.",
+        browseAllLabel: "Browse all APIs",
+        browseAllHref: "/api",
+        autoFromOpenApi: true,
+        items: [
+          {
+            name: "List resources",
+            path: "/v1/items",
+            icon: "boxes",
+            latency: "28ms"
+          },
+          {
+            name: "Create resource",
+            path: "/v1/items",
+            icon: "badge-dollar-sign",
+            latency: "34ms"
+          },
+          {
+            name: "Get resource",
+            path: "/v1/items/{id}",
+            icon: "layers",
+            latency: "19ms"
+          },
+          {
+            name: "Search",
+            path: "/v1/search",
+            icon: "arrow-left-right",
+            latency: "41ms"
+          },
+          {
+            name: "User profile",
+            path: "/v1/users/me",
+            icon: "wallet",
+            latency: "52ms"
+          },
+          {
+            name: "Health check",
+            path: "/v1/health",
+            icon: "activity",
+            latency: "16ms"
+          },
+          {
+            name: "Metadata",
+            path: "/v1/meta",
+            icon: "coins",
+            latency: "22ms"
+          },
+          {
+            name: "Rate limits",
+            path: "/v1/limits",
+            icon: "gauge",
+            latency: "16ms"
+          }
+        ]
+      },
+      pricingCta: {
+        title: "Start free. Scale when you do.",
+        description: "10,000 requests a month, free forever. Upgrade only when your app takes off.",
+        primaryAction: { label: "Create free account", href: "/register" },
+        secondaryAction: { label: "See pricing", href: "/pricing" }
+      },
+      showPoweredBy: true
+    };
+  }
+});
+
 // src/config/resolve-modules.ts
-var hasExplicitModules, joinPanelPath, DEFAULT_LANDING_FEATURES, resolveLandingContent, DEFAULT_DASHBOARD_QUICK_LINKS, resolveDashboardContent, resolveProfileContent, resolvePlansContent, resolveModulesConfig;
+var hasExplicitModules, joinPanelPath, mergeLandingSection, buildDefaultLandingContent, resolveLandingContent, DEFAULT_DASHBOARD_QUICK_LINKS, resolveDashboardContent, resolveProfileContent, resolvePlansContent, resolveModulesConfig;
 var init_resolve_modules = __esm({
   "src/config/resolve-modules.ts"() {
+    init_default_landing_content();
     init_ModulesSchema();
     hasExplicitModules = (config2) => config2.modules !== void 0;
     joinPanelPath = (basePath, routePath) => {
@@ -1049,55 +1209,98 @@ var init_resolve_modules = __esm({
       }
       return `/${`${base}/${route}`.replace(/^\/+/, "")}`;
     };
-    DEFAULT_LANDING_FEATURES = [
-      {
-        title: "Documentation",
-        description: "Write guides and references in Markdown or MDX with full navigation and search."
-      },
-      {
-        title: "API Reference",
-        description: "Publish interactive OpenAPI docs with a built-in playground and code samples."
-      },
-      {
-        title: "Developer Portal",
-        description: "Extend with landing pages, authentication, API keys, and subscription modules."
+    mergeLandingSection = (defaults, override) => {
+      if (override?.enabled === false) {
+        return void 0;
       }
-    ];
-    resolveLandingContent = (config2, content) => {
+      if (!defaults && !override) {
+        return void 0;
+      }
+      return { ...defaults, ...override };
+    };
+    buildDefaultLandingContent = (config2) => {
       const siteTitle = config2.metadata?.applicationName ?? config2.site?.title ?? "APIToGo";
-      const resolved = {
+      return {
+        ...DEFAULT_LANDING_CONTENT,
         hero: {
-          title: content?.hero?.title ?? siteTitle,
-          subtitle: content?.hero?.subtitle ?? "Developer portal",
-          description: content?.hero?.description ?? config2.metadata?.description ?? "Ship beautiful API documentation and developer experiences with APIToGo.",
-          badge: content?.hero?.badge,
-          highlights: content?.hero?.highlights,
-          codeExample: content?.hero?.codeExample
+          ...DEFAULT_LANDING_CONTENT.hero,
+          title: `${siteTitle} APIs that ship`
         },
-        features: content?.features ?? DEFAULT_LANDING_FEATURES,
-        primaryAction: content?.primaryAction ?? {
-          label: "Get started",
-          href: "/introduction"
+        primaryAction: {
+          ...DEFAULT_LANDING_CONTENT.primaryAction,
+          href: "/introduction",
+          label: "Get started"
         },
-        secondaryAction: content?.secondaryAction ?? {
-          label: "API Reference",
-          href: "/api"
+        secondaryAction: {
+          ...DEFAULT_LANDING_CONTENT.secondaryAction,
+          href: "/api",
+          label: "API Reference"
         },
-        showPoweredBy: content?.showPoweredBy
+        pricingCta: DEFAULT_LANDING_CONTENT.pricingCta ? {
+          ...DEFAULT_LANDING_CONTENT.pricingCta,
+          primaryAction: {
+            label: "Get started",
+            href: "/introduction"
+          },
+          secondaryAction: {
+            label: "See pricing",
+            href: "/pricing"
+          }
+        } : void 0
       };
-      if (content?.ticker && content.ticker.enabled !== false) {
-        resolved.ticker = content.ticker;
-      }
-      if (content?.trust && content.trust.enabled !== false) {
-        resolved.trust = content.trust;
-      }
-      if (content?.apiShowcase && content.apiShowcase.enabled !== false) {
-        resolved.apiShowcase = content.apiShowcase;
+    };
+    resolveLandingContent = (config2, content, options) => {
+      const siteTitle = config2.metadata?.applicationName ?? config2.site?.title ?? "APIToGo";
+      if (options?.useDefaults === true) {
+        const defaults = buildDefaultLandingContent(config2);
+        return {
+          hero: {
+            ...defaults.hero,
+            ...content?.hero,
+            title: content?.hero?.title ?? defaults.hero?.title,
+            description: content?.hero?.description ?? config2.metadata?.description ?? defaults.hero?.description,
+            codeExample: content?.hero?.codeExample ?? defaults.hero?.codeExample,
+            titleAccent: content?.hero?.titleAccent ?? (content?.hero?.title ? void 0 : defaults.hero?.titleAccent)
+          },
+          featuresSection: mergeLandingSection(
+            defaults.featuresSection,
+            content?.featuresSection
+          ),
+          features: content?.features ?? defaults.features,
+          primaryAction: content?.primaryAction ?? defaults.primaryAction,
+          secondaryAction: content?.secondaryAction ?? defaults.secondaryAction,
+          showPoweredBy: content?.showPoweredBy ?? defaults.showPoweredBy,
+          ticker: mergeLandingSection(defaults.ticker, content?.ticker),
+          trust: mergeLandingSection(defaults.trust, content?.trust),
+          apiShowcase: mergeLandingSection(
+            defaults.apiShowcase,
+            content?.apiShowcase
+          ),
+          pricingCta: mergeLandingSection(defaults.pricingCta, content?.pricingCta)
+        };
       }
-      if (content?.pricingCta && content.pricingCta.enabled !== false) {
-        resolved.pricingCta = content.pricingCta;
+      const hasContent = content !== void 0 && Object.keys(content).length > 0;
+      if (!hasContent) {
+        return {
+          hero: { title: siteTitle },
+          showPoweredBy: true
+        };
       }
-      return resolved;
+      return {
+        hero: {
+          ...content.hero,
+          title: content.hero?.title ?? siteTitle
+        },
+        featuresSection: content.featuresSection ? mergeLandingSection(void 0, content.featuresSection) : void 0,
+        features: content.features,
+        primaryAction: content.primaryAction,
+        secondaryAction: content.secondaryAction,
+        showPoweredBy: content.showPoweredBy ?? true,
+        ticker: content.ticker ? mergeLandingSection(void 0, content.ticker) : void 0,
+        trust: content.trust ? mergeLandingSection(void 0, content.trust) : void 0,
+        apiShowcase: content.apiShowcase ? mergeLandingSection(void 0, content.apiShowcase) : void 0,
+        pricingCta: content.pricingCta ? mergeLandingSection(void 0, content.pricingCta) : void 0
+      };
     };
     DEFAULT_DASHBOARD_QUICK_LINKS = [
       { label: "Documentation", href: "/introduction" },
@@ -1151,7 +1354,9 @@ var init_resolve_modules = __esm({
           path: landingModule?.path ?? "/",
           component: landingModule?.component,
           layout: landingModule?.layout ?? "landing",
-          content: resolveLandingContent(config2, landingModule?.content)
+          content: resolveLandingContent(config2, landingModule?.content, {
+            useDefaults: landingModule?.useDefaults === true
+          })
         },
         userPanel: {
           enabled: userPanelEnabled,
@@ -4980,7 +5185,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.55",
+  version: "0.1.56",
   type: "module",
   sideEffects: [
     "**/*.css",

package/dist/declarations/config/default-landing-content.d.ts

@@ -0,0 +1,2 @@
+import type { ResolvedLandingContent } from "./validators/ModulesSchema.js";
+export declare const DEFAULT_LANDING_CONTENT: ResolvedLandingContent;

package/dist/declarations/config/landing-manifest.d.ts

@@ -3,6 +3,7 @@ import { LandingContentSchema } from "./validators/ModulesSchema.js";
 export declare const LandingManifestContentSchema: z.ZodOptional<z.ZodObject<{
     hero: z.ZodOptional<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
+        titleAccent: z.ZodOptional<z.ZodString>;
         subtitle: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         badge: z.ZodOptional<z.ZodString>;
@@ -13,6 +14,11 @@ export declare const LandingManifestContentSchema: z.ZodOptional<z.ZodObject<{
             code: z.ZodString;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    featuresSection: z.ZodOptional<z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     features: z.ZodOptional<z.ZodArray<z.ZodObject<{
         title: z.ZodString;
         description: z.ZodString;

package/dist/declarations/config/local-manifest.d.ts

@@ -91,6 +91,7 @@ export declare const DevPortalLocalManifestSchema: z.ZodObject<{
         content: z.ZodOptional<z.ZodObject<{
             hero: z.ZodOptional<z.ZodObject<{
                 title: z.ZodOptional<z.ZodString>;
+                titleAccent: z.ZodOptional<z.ZodString>;
                 subtitle: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
                 badge: z.ZodOptional<z.ZodString>;
@@ -101,6 +102,11 @@ export declare const DevPortalLocalManifestSchema: z.ZodObject<{
                     code: z.ZodString;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
+            featuresSection: z.ZodOptional<z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                title: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
             features: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 title: z.ZodString;
                 description: z.ZodString;

package/dist/declarations/config/resolve-modules.d.ts

@@ -1,7 +1,9 @@
 import { type ResolvedModulesConfig, type LandingContentConfig, type ResolvedLandingContent, type DashboardContentConfig, type ProfileContentConfig, type PlansContentConfig, type ResolvedDashboardContent, type ResolvedProfileContent, type ResolvedPlansContent } from "./validators/ModulesSchema.js";
 import type { ZudokuConfig } from "./validators/ZudokuConfig.js";
 export declare const joinPanelPath: (basePath: string, routePath: string) => string;
-export declare const resolveLandingContent: (config: ZudokuConfig, content?: LandingContentConfig) => ResolvedLandingContent;
+export declare const resolveLandingContent: (config: ZudokuConfig, content?: LandingContentConfig, options?: {
+    useDefaults?: boolean;
+}) => ResolvedLandingContent;
 export declare const resolveDashboardContent: (content?: DashboardContentConfig) => ResolvedDashboardContent;
 export declare const resolveProfileContent: (content?: ProfileContentConfig) => ResolvedProfileContent;
 export declare const resolvePlansContent: (content?: PlansContentConfig) => ResolvedPlansContent;

package/dist/declarations/config/validators/ModulesSchema.d.ts

@@ -36,6 +36,7 @@ export declare const LandingCodeExampleSchema: z.ZodOptional<z.ZodObject<{
 }, z.core.$strip>>;
 export declare const LandingHeroSchema: z.ZodOptional<z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
+    titleAccent: z.ZodOptional<z.ZodString>;
     subtitle: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
     badge: z.ZodOptional<z.ZodString>;
@@ -46,6 +47,11 @@ export declare const LandingHeroSchema: z.ZodOptional<z.ZodObject<{
         code: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>>;
+export declare const LandingFeaturesSectionSchema: z.ZodOptional<z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
 export declare const LandingTickerItemSchema: z.ZodObject<{
     label: z.ZodString;
     value: z.ZodString;
@@ -102,6 +108,7 @@ export declare const LandingPricingCtaSchema: z.ZodOptional<z.ZodObject<{
 export declare const LandingContentSchema: z.ZodOptional<z.ZodObject<{
     hero: z.ZodOptional<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
+        titleAccent: z.ZodOptional<z.ZodString>;
         subtitle: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         badge: z.ZodOptional<z.ZodString>;
@@ -112,6 +119,11 @@ export declare const LandingContentSchema: z.ZodOptional<z.ZodObject<{
             code: z.ZodString;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    featuresSection: z.ZodOptional<z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     features: z.ZodOptional<z.ZodArray<z.ZodObject<{
         title: z.ZodString;
         description: z.ZodString;
@@ -212,6 +224,7 @@ export declare const LandingModuleSchema: z.ZodObject<{
     content: z.ZodOptional<z.ZodObject<{
         hero: z.ZodOptional<z.ZodObject<{
             title: z.ZodOptional<z.ZodString>;
+            titleAccent: z.ZodOptional<z.ZodString>;
             subtitle: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             badge: z.ZodOptional<z.ZodString>;
@@ -222,6 +235,11 @@ export declare const LandingModuleSchema: z.ZodObject<{
                 code: z.ZodString;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        featuresSection: z.ZodOptional<z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         features: z.ZodOptional<z.ZodArray<z.ZodObject<{
             title: z.ZodString;
             description: z.ZodString;
@@ -278,6 +296,7 @@ export declare const LandingModuleSchema: z.ZodObject<{
         }, z.core.$strip>>;
         showPoweredBy: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    useDefaults: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const UserManagementModuleSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
@@ -442,6 +461,7 @@ export declare const ModulesSchema: z.ZodOptional<z.ZodObject<{
         content: z.ZodOptional<z.ZodObject<{
             hero: z.ZodOptional<z.ZodObject<{
                 title: z.ZodOptional<z.ZodString>;
+                titleAccent: z.ZodOptional<z.ZodString>;
                 subtitle: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
                 badge: z.ZodOptional<z.ZodString>;
@@ -452,6 +472,11 @@ export declare const ModulesSchema: z.ZodOptional<z.ZodObject<{
                     code: z.ZodString;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
+            featuresSection: z.ZodOptional<z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                title: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
             features: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 title: z.ZodString;
                 description: z.ZodString;
@@ -508,6 +533,7 @@ export declare const ModulesSchema: z.ZodOptional<z.ZodObject<{
             }, z.core.$strip>>;
             showPoweredBy: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
+        useDefaults: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     userPanel: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -604,12 +630,18 @@ export type LandingPricingCtaConfig = z.infer<typeof LandingPricingCtaSchema>;
 export type ResolvedLandingContent = {
     hero?: {
         title?: string;
+        titleAccent?: string;
         subtitle?: string;
         description?: string;
         badge?: string;
         highlights?: string[];
         codeExample?: NonNullable<LandingCodeExampleConfig>;
     };
+    featuresSection?: {
+        label?: string;
+        title?: string;
+        description?: string;
+    };
     features?: LandingFeatureConfig[];
     primaryAction?: LandingLinkConfig;
     secondaryAction?: LandingLinkConfig;

package/dist/declarations/config/validators/ZudokuConfig.d.ts

@@ -6890,6 +6890,7 @@ export declare const ZudokuConfig: z.ZodObject<{
             content: z.ZodOptional<z.ZodObject<{
                 hero: z.ZodOptional<z.ZodObject<{
                     title: z.ZodOptional<z.ZodString>;
+                    titleAccent: z.ZodOptional<z.ZodString>;
                     subtitle: z.ZodOptional<z.ZodString>;
                     description: z.ZodOptional<z.ZodString>;
                     badge: z.ZodOptional<z.ZodString>;
@@ -6900,6 +6901,11 @@ export declare const ZudokuConfig: z.ZodObject<{
                         code: z.ZodString;
                     }, z.core.$strip>>;
                 }, z.core.$strip>>;
+                featuresSection: z.ZodOptional<z.ZodObject<{
+                    label: z.ZodOptional<z.ZodString>;
+                    title: z.ZodOptional<z.ZodString>;
+                    description: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
                 features: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     title: z.ZodString;
                     description: z.ZodString;
@@ -6956,6 +6962,7 @@ export declare const ZudokuConfig: z.ZodObject<{
                 }, z.core.$strip>>;
                 showPoweredBy: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
+            useDefaults: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
         userPanel: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;

package/dist/declarations/lib/authentication/providers/dev-portal-utils.d.ts

@@ -4,6 +4,7 @@ export declare function resolveDevPortalApiBaseUrl(config: Pick<DevPortalAuthent
 export declare function isPlaceholderDevPortalApiUrl(apiBaseUrl: string | undefined): boolean;
 export declare function toAbsoluteReturnUrl(pathOrUrl: string): string;
 export declare function buildDevPortalOidcChallengeUrl(apiBaseUrl: string, providerId: string, returnUrl: string): string;
+export declare function buildDevPortalLoginUrl(apiBaseUrl: string, returnUrl: string): string;
 export declare function buildDevPortalLogoutUrl(apiBaseUrl: string, returnUrl: string): string;
 export declare function normalizeDevPortalAuthConfig(raw: unknown): import("./dev-portal-constants.js").DevPortalAuthConfigResponse;
 export declare function isNativeAuthEnabled(config: import("./dev-portal-constants.js").DevPortalAuthConfigResponse | null | undefined): boolean;

package/dist/flat-config.d.ts

@@ -64,7 +64,7 @@ export type _Schema15 = boolean
 /**
  * Gateway plan catalog for /pricing preview and publish (canonical storage).
  */
-export type _Schema35 = {
+export type _Schema37 = {
   sku: string
   displayName: string
   priceAmount?: number
@@ -73,31 +73,31 @@ export type _Schema35 = {
   limitsJson?: string
   includedActionKeys?: string[]
 }[]
-export type _Schema36 = ({
+export type _Schema38 = ({
   type: "url"
-  input: (string | _Schema37[])
-  server?: _Schema38
-  path?: _Schema39
-  categories?: _Schema40
-  options?: _Schema42
+  input: (string | _Schema39[])
+  server?: _Schema40
+  path?: _Schema41
+  categories?: _Schema42
+  options?: _Schema44
 } | {
   type: "file"
-  input: (string | (string | _Schema37)[])
-  server?: _Schema38
-  path?: _Schema39
-  categories?: _Schema40
-  options?: _Schema42
+  input: (string | (string | _Schema39)[])
+  server?: _Schema40
+  path?: _Schema41
+  categories?: _Schema42
+  options?: _Schema44
 } | {
   type: "raw"
   input: string
-  server?: _Schema38
-  path?: _Schema39
-  categories?: _Schema40
-  options?: _Schema42
+  server?: _Schema40
+  path?: _Schema41
+  categories?: _Schema42
+  options?: _Schema44
 })
-export type _Schema38 = string
-export type _Schema39 = string
-export type _Schema40 = {
+export type _Schema40 = string
+export type _Schema41 = string
+export type _Schema42 = {
   label: string
   tags: string[]
 }[]
@@ -396,10 +396,10 @@ export interface FlatZudokuConfig {
   modules?: {
     docs?: _Schema14
     landing?: _Schema16
-    userPanel?: _Schema23
+    userPanel?: _Schema25
   }
-  apis?: (_Schema36 | _Schema36[])
-  catalogs?: (_Schema43 | _Schema43[])
+  apis?: (_Schema38 | _Schema38[])
+  catalogs?: (_Schema45 | _Schema45[])
   apiKeys?: {
     enabled: boolean
     getConsumers?: unknown
@@ -427,7 +427,7 @@ export interface FlatZudokuConfig {
   }
   enableStatusPages?: boolean
   defaults?: {
-    apis: _Schema42
+    apis: _Schema44
     examplesLanguage?: string
   }
   __pluginDirs?: string[]
@@ -525,6 +525,10 @@ export interface _Schema16 {
    */
   layout?: ("default" | "landing" | "none")
   content?: _Schema21
+  /**
+   * When true, merge DEFAULT_LANDING_CONTENT for unset sections. When false or omitted, only configured sections are shown.
+   */
+  useDefaults?: boolean
 }
 /**
  * Default landing page content when no custom component is provided.
@@ -532,6 +536,10 @@ export interface _Schema16 {
 export interface _Schema21 {
   hero?: {
     title?: string
+    /**
+     * Accent-colored word or phrase shown on a new line after the title.
+     */
+    titleAccent?: string
     subtitle?: string
     description?: string
     badge?: string
@@ -542,13 +550,18 @@ export interface _Schema21 {
       code: string
     }
   }
+  featuresSection?: {
+    label?: string
+    title?: string
+    description?: string
+  }
   features?: {
     title: string
     description: string
     icon?: string
   }[]
-  primaryAction?: _Schema22
-  secondaryAction?: _Schema22
+  primaryAction?: _Schema23
+  secondaryAction?: _Schema23
   ticker?: {
     enabled?: boolean
     items?: {
@@ -581,19 +594,19 @@ export interface _Schema21 {
     enabled?: boolean
     title?: string
     description?: string
-    primaryAction?: _Schema22
-    secondaryAction?: _Schema22
+    primaryAction?: _Schema23
+    secondaryAction?: _Schema23
   }
   showPoweredBy?: boolean
 }
-export interface _Schema22 {
+export interface _Schema23 {
   label: string
   href: string
 }
 /**
  * User panel module — authenticated user area with sub-modules.
  */
-export interface _Schema23 {
+export interface _Schema25 {
   enabled?: _Schema15
   /**
    * Base path prefix for user panel routes.
@@ -615,7 +628,7 @@ export interface _Schema23 {
     component?: {
       [k: string]: unknown
     }
-    content?: _Schema30
+    content?: _Schema32
   }
   userManagement?: {
     enabled?: _Schema15
@@ -635,7 +648,7 @@ export interface _Schema23 {
     component?: {
       [k: string]: unknown
     }
-    content?: _Schema31
+    content?: _Schema33
   }
   apiKeys?: {
     enabled?: _Schema15
@@ -660,30 +673,30 @@ export interface _Schema23 {
     component?: {
       [k: string]: unknown
     }
-    content?: _Schema34
-    items?: _Schema35
+    content?: _Schema36
+    items?: _Schema37
   }
 }
 /**
  * Default dashboard page content when no custom component is provided.
  */
-export interface _Schema30 {
+export interface _Schema32 {
   title?: string
   subtitle?: string
   description?: string
-  quickLinks?: _Schema22[]
+  quickLinks?: _Schema23[]
 }
 /**
  * Default profile page content when no custom component is provided.
  */
-export interface _Schema31 {
+export interface _Schema33 {
   title?: string
   description?: string
 }
 /**
  * Default plans page content when no custom component is provided.
  */
-export interface _Schema34 {
+export interface _Schema36 {
   title?: string
   description?: string
   tiers?: {
@@ -692,12 +705,12 @@ export interface _Schema34 {
     description?: string
   }[]
 }
-export interface _Schema37 {
+export interface _Schema39 {
   path: string
   input: string
   label?: string
 }
-export interface _Schema42 {
+export interface _Schema44 {
   examplesLanguage?: string
   supportedLanguages?: {
     value: string
@@ -714,7 +727,7 @@ export interface _Schema42 {
   transformExamples?: unknown
   generateCodeSnippet?: unknown
 }
-export interface _Schema43 {
+export interface _Schema45 {
   path: string
   label: string
   items?: string[]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lukoweb/apitogo",
-  "version": "0.1.55",
+  "version": "0.1.56",
   "type": "module",
   "sideEffects": [
     "**/*.css",

package/src/config/default-landing-content.ts

@@ -0,0 +1,154 @@
+import type { ResolvedLandingContent } from "./validators/ModulesSchema.js";
+
+/** Default landing sections aligned with webapp-template/APIToGo.dc.html */
+export const DEFAULT_LANDING_CONTENT: ResolvedLandingContent = {
+  hero: {
+    badge: "99.98% uptime",
+    subtitle: "Production-ready APIs, one endpoint away",
+    title: "Developer APIs that ship",
+    titleAccent: "today.",
+    description:
+      "Documentation, interactive API reference, auth, and billing — sub-40ms responses, one API key, generous free tier.",
+    highlights: ["No credit card", "10k requests free", "SDKs for 6 languages"],
+    codeExample: {
+      filename: "example.sh",
+      language: "bash",
+      code: `$ curl https://api.example.com/v1/items \\
+  -H "Authorization: Bearer YOUR_API_KEY" \\
+  -d "limit=10"
+
+{
+  "items": [
+    { "id": "item_1", "name": "Widget", "status": "active" },
+    { "id": "item_2", "name": "Gadget", "status": "active" }
+  ]
+} // 28ms`,
+    },
+  },
+  primaryAction: { label: "Get your API key", href: "/register" },
+  secondaryAction: { label: "Read the docs", href: "/introduction" },
+  ticker: {
+    items: [
+      { label: "GET", value: "/v1/items", change: "28ms" },
+      { label: "POST", value: "/v1/items", change: "34ms" },
+      { label: "GET", value: "/v1/users", change: "19ms" },
+      { label: "PATCH", value: "/v1/users/{id}", change: "41ms" },
+      { label: "GET", value: "/v1/health", change: "16ms" },
+      { label: "DELETE", value: "/v1/items/{id}", change: "22ms" },
+      { label: "GET", value: "/v1/search", change: "47ms" },
+      { label: "POST", value: "/v1/auth/token", change: "52ms" },
+    ],
+  },
+  trust: {
+    title: "Trusted by teams shipping production APIs",
+    logos: ["Acme Corp", "BuildFast", "DataFlow", "ShipKit", "DevStack", "LaunchPad"],
+  },
+  featuresSection: {
+    label: "// why us",
+    title: "Everything you need to build on your API",
+    description:
+      "Skip the infra. We handle docs, auth, keys, and billing so you can focus on your product.",
+  },
+  features: [
+    {
+      icon: "gauge",
+      title: "Sub-40ms responses",
+      description:
+        "Edge-cached and globally distributed, so your app feels instant anywhere.",
+    },
+    {
+      icon: "radio",
+      title: "Real-time streams",
+      description:
+        "WebSocket feeds with automatic reconnection for live data and events.",
+    },
+    {
+      icon: "blocks",
+      title: "Unified schema",
+      description:
+        "One consistent API design — no per-endpoint glue code or custom adapters.",
+    },
+    {
+      icon: "shield-check",
+      title: "99.98% uptime",
+      description:
+        "Redundant infra with a public status page and an SLA on paid plans.",
+    },
+    {
+      icon: "code",
+      title: "SDKs for 6 languages",
+      description:
+        "Typed clients for JS, Python, Go, Rust, Ruby and PHP. Copy, paste, ship.",
+    },
+    {
+      icon: "webhook",
+      title: "Webhooks & alerts",
+      description:
+        "Push events and threshold alerts straight to your endpoints.",
+    },
+  ],
+  apiShowcase: {
+    title: "Production APIs. One key.",
+    browseAllLabel: "Browse all APIs",
+    browseAllHref: "/api",
+    autoFromOpenApi: true,
+    items: [
+      {
+        name: "List resources",
+        path: "/v1/items",
+        icon: "boxes",
+        latency: "28ms",
+      },
+      {
+        name: "Create resource",
+        path: "/v1/items",
+        icon: "badge-dollar-sign",
+        latency: "34ms",
+      },
+      {
+        name: "Get resource",
+        path: "/v1/items/{id}",
+        icon: "layers",
+        latency: "19ms",
+      },
+      {
+        name: "Search",
+        path: "/v1/search",
+        icon: "arrow-left-right",
+        latency: "41ms",
+      },
+      {
+        name: "User profile",
+        path: "/v1/users/me",
+        icon: "wallet",
+        latency: "52ms",
+      },
+      {
+        name: "Health check",
+        path: "/v1/health",
+        icon: "activity",
+        latency: "16ms",
+      },
+      {
+        name: "Metadata",
+        path: "/v1/meta",
+        icon: "coins",
+        latency: "22ms",
+      },
+      {
+        name: "Rate limits",
+        path: "/v1/limits",
+        icon: "gauge",
+        latency: "16ms",
+      },
+    ],
+  },
+  pricingCta: {
+    title: "Start free. Scale when you do.",
+    description:
+      "10,000 requests a month, free forever. Upgrade only when your app takes off.",
+    primaryAction: { label: "Create free account", href: "/register" },
+    secondaryAction: { label: "See pricing", href: "/pricing" },
+  },
+  showPoweredBy: true,
+};

package/src/config/resolve-modules.ts

@@ -1,3 +1,4 @@
+import { DEFAULT_LANDING_CONTENT } from "./default-landing-content.js";
 import {
   type ResolvedModulesConfig,
   ModulesSchema,
@@ -32,72 +33,137 @@ export const joinPanelPath = (basePath: string, routePath: string): string => {
   return `/${`${base}/${route}`.replace(/^\/+/, "")}`;
 };
 
-const DEFAULT_LANDING_FEATURES: ResolvedLandingContent["features"] = [
-  {
-    title: "Documentation",
-    description:
-      "Write guides and references in Markdown or MDX with full navigation and search.",
-  },
-  {
-    title: "API Reference",
-    description:
-      "Publish interactive OpenAPI docs with a built-in playground and code samples.",
-  },
-  {
-    title: "Developer Portal",
-    description:
-      "Extend with landing pages, authentication, API keys, and subscription modules.",
-  },
-];
+const mergeLandingSection = <T extends { enabled?: boolean }>(
+  defaults: T | undefined,
+  override: T | undefined,
+): T | undefined => {
+  if (override?.enabled === false) {
+    return undefined;
+  }
 
-export const resolveLandingContent = (
+  if (!defaults && !override) {
+    return undefined;
+  }
+
+  return { ...defaults, ...override } as T;
+};
+
+const buildDefaultLandingContent = (
   config: ZudokuConfig,
-  content?: LandingContentConfig,
 ): ResolvedLandingContent => {
   const siteTitle =
     config.metadata?.applicationName ?? config.site?.title ?? "APIToGo";
 
-  const resolved: ResolvedLandingContent = {
+  return {
+    ...DEFAULT_LANDING_CONTENT,
     hero: {
-      title: content?.hero?.title ?? siteTitle,
-      subtitle: content?.hero?.subtitle ?? "Developer portal",
-      description:
-        content?.hero?.description ??
-        config.metadata?.description ??
-        "Ship beautiful API documentation and developer experiences with APIToGo.",
-      badge: content?.hero?.badge,
-      highlights: content?.hero?.highlights,
-      codeExample: content?.hero?.codeExample,
+      ...DEFAULT_LANDING_CONTENT.hero,
+      title: `${siteTitle} APIs that ship`,
     },
-    features: content?.features ?? DEFAULT_LANDING_FEATURES,
-    primaryAction: content?.primaryAction ?? {
-      label: "Get started",
+    primaryAction: {
+      ...DEFAULT_LANDING_CONTENT.primaryAction,
       href: "/introduction",
+      label: "Get started",
     },
-    secondaryAction: content?.secondaryAction ?? {
-      label: "API Reference",
+    secondaryAction: {
+      ...DEFAULT_LANDING_CONTENT.secondaryAction,
       href: "/api",
+      label: "API Reference",
     },
-    showPoweredBy: content?.showPoweredBy,
+    pricingCta: DEFAULT_LANDING_CONTENT.pricingCta
+      ? {
+          ...DEFAULT_LANDING_CONTENT.pricingCta,
+          primaryAction: {
+            label: "Get started",
+            href: "/introduction",
+          },
+          secondaryAction: {
+            label: "See pricing",
+            href: "/pricing",
+          },
+        }
+      : undefined,
   };
+};
 
-  if (content?.ticker && content.ticker.enabled !== false) {
-    resolved.ticker = content.ticker;
-  }
+export const resolveLandingContent = (
+  config: ZudokuConfig,
+  content?: LandingContentConfig,
+  options?: { useDefaults?: boolean },
+): ResolvedLandingContent => {
+  const siteTitle =
+    config.metadata?.applicationName ?? config.site?.title ?? "APIToGo";
 
-  if (content?.trust && content.trust.enabled !== false) {
-    resolved.trust = content.trust;
+  if (options?.useDefaults === true) {
+    const defaults = buildDefaultLandingContent(config);
+
+    return {
+      hero: {
+        ...defaults.hero,
+        ...content?.hero,
+        title: content?.hero?.title ?? defaults.hero?.title,
+        description:
+          content?.hero?.description ??
+          config.metadata?.description ??
+          defaults.hero?.description,
+        codeExample: content?.hero?.codeExample ?? defaults.hero?.codeExample,
+        titleAccent:
+          content?.hero?.titleAccent ??
+          (content?.hero?.title ? undefined : defaults.hero?.titleAccent),
+      },
+      featuresSection: mergeLandingSection(
+        defaults.featuresSection,
+        content?.featuresSection,
+      ),
+      features: content?.features ?? defaults.features,
+      primaryAction: content?.primaryAction ?? defaults.primaryAction,
+      secondaryAction: content?.secondaryAction ?? defaults.secondaryAction,
+      showPoweredBy: content?.showPoweredBy ?? defaults.showPoweredBy,
+      ticker: mergeLandingSection(defaults.ticker, content?.ticker),
+      trust: mergeLandingSection(defaults.trust, content?.trust),
+      apiShowcase: mergeLandingSection(
+        defaults.apiShowcase,
+        content?.apiShowcase,
+      ),
+      pricingCta: mergeLandingSection(defaults.pricingCta, content?.pricingCta),
+    };
   }
 
-  if (content?.apiShowcase && content.apiShowcase.enabled !== false) {
-    resolved.apiShowcase = content.apiShowcase;
-  }
+  const hasContent =
+    content !== undefined && Object.keys(content).length > 0;
 
-  if (content?.pricingCta && content.pricingCta.enabled !== false) {
-    resolved.pricingCta = content.pricingCta;
+  if (!hasContent) {
+    return {
+      hero: { title: siteTitle },
+      showPoweredBy: true,
+    };
   }
 
-  return resolved;
+  return {
+    hero: {
+      ...content.hero,
+      title: content.hero?.title ?? siteTitle,
+    },
+    featuresSection: content.featuresSection
+      ? mergeLandingSection(undefined, content.featuresSection)
+      : undefined,
+    features: content.features,
+    primaryAction: content.primaryAction,
+    secondaryAction: content.secondaryAction,
+    showPoweredBy: content.showPoweredBy ?? true,
+    ticker: content.ticker
+      ? mergeLandingSection(undefined, content.ticker)
+      : undefined,
+    trust: content.trust
+      ? mergeLandingSection(undefined, content.trust)
+      : undefined,
+    apiShowcase: content.apiShowcase
+      ? mergeLandingSection(undefined, content.apiShowcase)
+      : undefined,
+    pricingCta: content.pricingCta
+      ? mergeLandingSection(undefined, content.pricingCta)
+      : undefined,
+  };
 };
 
 const DEFAULT_DASHBOARD_QUICK_LINKS: ResolvedDashboardContent["quickLinks"] = [
@@ -193,7 +259,9 @@ export const resolveModulesConfig = (
       path: landingModule?.path ?? "/",
       component: landingModule?.component,
       layout: landingModule?.layout ?? "landing",
-      content: resolveLandingContent(config, landingModule?.content),
+      content: resolveLandingContent(config, landingModule?.content, {
+        useDefaults: landingModule?.useDefaults === true,
+      }),
     },
     userPanel: {
       enabled: userPanelEnabled,

package/src/config/validators/ModulesSchema.ts

@@ -58,6 +58,10 @@ export const LandingCodeExampleSchema = z
 export const LandingHeroSchema = z
   .object({
     title: z.string().optional(),
+    titleAccent: z
+      .string()
+      .optional()
+      .describe("Accent-colored word or phrase shown on a new line after the title."),
     subtitle: z.string().optional(),
     description: z.string().optional(),
     badge: z.string().optional(),
@@ -66,6 +70,14 @@ export const LandingHeroSchema = z
   })
   .optional();
 
+export const LandingFeaturesSectionSchema = z
+  .object({
+    label: z.string().optional(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+  })
+  .optional();
+
 export const LandingTickerItemSchema = z.object({
   label: z.string(),
   value: z.string(),
@@ -120,6 +132,7 @@ export const LandingPricingCtaSchema = z
 export const LandingContentSchema = z
   .object({
     hero: LandingHeroSchema,
+    featuresSection: LandingFeaturesSectionSchema,
     features: z.array(LandingFeatureSchema).optional(),
     primaryAction: LandingLinkSchema.optional(),
     secondaryAction: LandingLinkSchema.optional(),
@@ -195,6 +208,12 @@ export const LandingModuleSchema = ModuleToggleSchema.extend({
   content: LandingContentSchema.describe(
     "Default landing page content when no custom component is provided.",
   ),
+  useDefaults: z
+    .boolean()
+    .optional()
+    .describe(
+      "When true, merge DEFAULT_LANDING_CONTENT for unset sections. When false or omitted, only configured sections are shown.",
+    ),
 });
 
 export const UserManagementModuleSchema = ModuleToggleSchema.extend({
@@ -326,12 +345,18 @@ export type LandingPricingCtaConfig = z.infer<typeof LandingPricingCtaSchema>;
 export type ResolvedLandingContent = {
   hero?: {
     title?: string;
+    titleAccent?: string;
     subtitle?: string;
     description?: string;
     badge?: string;
     highlights?: string[];
     codeExample?: NonNullable<LandingCodeExampleConfig>;
   };
+  featuresSection?: {
+    label?: string;
+    title?: string;
+    description?: string;
+  };
   features?: LandingFeatureConfig[];
   primaryAction?: LandingLinkConfig;
   secondaryAction?: LandingLinkConfig;

package/src/lib/authentication/providers/dev-portal-utils.ts

@@ -66,6 +66,15 @@ export function buildDevPortalOidcChallengeUrl(
   return url.toString();
 }
 
+export function buildDevPortalLoginUrl(
+  apiBaseUrl: string,
+  returnUrl: string,
+): string {
+  const url = new URL("/api/v1/auth/login", apiBaseUrl);
+  url.searchParams.set("returnUrl", toAbsoluteReturnUrl(returnUrl));
+  return url.toString();
+}
+
 export function buildDevPortalLogoutUrl(
   apiBaseUrl: string,
   returnUrl: string,