@digitalygo/create-diggocms-app 0.1.0

package/templates/full/lib/diggo-config.ts

@@ -0,0 +1,48 @@
+import type { ComponentRegistry, NavigationRegistry, DiggoConfig } from '@digitalygo/diggocms-sdk-core';
+import {
+  ExtendedTitle,
+  ExtendedSubtitle,
+  ExtendedImage,
+  ExtendedRichtext,
+  ExtendedCard,
+  ExtendedMenuItem,
+  ExtendedMenuContainer,
+} from '@/components/server-components';
+
+export const componentsRegistry: ComponentRegistry = {
+  subtitle: ExtendedSubtitle,
+  image: ExtendedImage,
+  richtext: ExtendedRichtext,
+  card: ExtendedCard,
+};
+
+export const navigationRegistry: NavigationRegistry = {
+  MenuItem: ExtendedMenuItem,
+  MenuContainer: ExtendedMenuContainer,
+};
+
+const isMock = process.env.MOCK === '1';
+const baseUrl = process.env.BASE_URL;
+const mockApiUrl = process.env.MOCK_API_URL;
+
+function getBaseUrl(): string {
+  if (isMock) {
+    return mockApiUrl ?? 'http://localhost:3001';
+  }
+
+  return baseUrl ?? 'http://placeholder.local';
+}
+
+export const sdkConfig: DiggoConfig = {
+  baseUrl: getBaseUrl(),
+  components: componentsRegistry,
+  navigation: navigationRegistry,
+};
+
+export function isMockMode(): boolean {
+  return isMock;
+}
+
+export function hasBaseUrl(): boolean {
+  return !!baseUrl;
+}

package/templates/full/next-env.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />

package/templates/full/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+};
+
+export default nextConfig;

package/templates/full/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "my-diggocms-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@digitalygo/diggocms-sdk-core": "^0.1.0",
+    "next": "^16.0.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "typescript": "^5.5.0"
+  }
+}

package/templates/full/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "ES2022"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/minimal/.env.local.example

@@ -0,0 +1,13 @@
+# DiggoCMS Environment Configuration
+# Copy this file to .env.local and update the values
+
+# CMS API Configuration
+# Set your DiggoCMS API base URL
+BASE_URL=https://your-cms-api.com
+
+# Mock Mode
+# Set to 1 to use local mock data instead of a real API
+MOCK=0
+
+# Mock API URL (only used when MOCK=1)
+MOCK_API_URL=http://localhost:3001

package/templates/minimal/README.md

@@ -0,0 +1,67 @@
+# My DiggoCMS App
+
+A minimal DiggoCMS application built with Next.js and the DiggoCMS SDK.
+
+## Getting Started
+
+1. Copy `.env.local.example` to `.env.local` and configure your environment:
+   ```bash
+   cp .env.local.example .env.local
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   # or
+   bun install
+   ```
+
+3. Run the development server:
+   ```bash
+   npm run dev
+   # or
+   bun run dev
+   ```
+
+4. Open [http://localhost:3000](http://localhost:3000) in your browser.
+
+## Configuration
+
+### Using a Real CMS API
+
+Set your CMS API base URL:
+```env
+BASE_URL=https://your-cms-api.com
+MOCK=0
+```
+
+### Using Mock Mode
+
+Enable mock mode to use local fixtures:
+```env
+MOCK=1
+MOCK_API_URL=http://localhost:3001
+```
+
+## Project Structure
+
+```
+app/              # Next.js app router
+components/       # React components (add your extended components here)
+lib/              # Utility functions and SDK configuration
+public/           # Static assets
+```
+
+## Next Steps
+
+This is a minimal template. To extend it:
+
+1. Create custom components in `components/`
+2. Register them in `lib/diggo-config.ts`
+3. Add navigation components if needed
+4. Set up your CMS API or mock server
+
+## Documentation
+
+- [DiggoCMS SDK Documentation](https://github.com/digitalygo/diggocms-sdk)
+- [Next.js Documentation](https://nextjs.org/docs)

package/templates/minimal/app/[...slug]/page.tsx

@@ -0,0 +1,56 @@
+import type { ReactElement } from 'react';
+import type { Metadata } from 'next';
+import { notFound } from 'next/navigation';
+import { fetchPageData } from '@/lib/data-fetching';
+import { renderPage } from '@digitalygo/diggocms-sdk-core/server';
+import { componentsRegistry } from '@/lib/diggo-config';
+
+export const dynamic = 'force-dynamic';
+
+interface CatchAllPageProps {
+  params: Promise<{ slug: string[] }>;
+}
+
+export async function generateMetadata({
+  params,
+}: CatchAllPageProps): Promise<Metadata> {
+  const { slug: slugParam } = await params;
+  const slug = (Array.isArray(slugParam) ? slugParam : []).join('/') || 'home';
+  const { page } = await fetchPageData(slug);
+
+  return {
+    title: page?.title,
+  };
+}
+
+export default async function CatchAllPage({
+  params,
+}: CatchAllPageProps): Promise<ReactElement> {
+  const { slug: slugParam } = await params;
+  const slug = (Array.isArray(slugParam) ? slugParam : []).join('/') || 'home';
+
+  const { page, error } = await fetchPageData(slug);
+
+  if (!page) {
+    notFound();
+  }
+
+  return (
+    <main style={{ maxWidth: '1200px', margin: '0 auto', padding: '2rem' }}>
+      {error && (
+        <div
+          style={{
+            background: '#fef3c7',
+            border: '1px solid #fbbf24',
+            padding: '1rem',
+            marginBottom: '1.5rem',
+            borderRadius: '0.375rem',
+          }}
+        >
+          <strong>Warning:</strong> {error}
+        </div>
+      )}
+      {renderPage(page, componentsRegistry)}
+    </main>
+  );
+}

package/templates/minimal/app/globals.css

@@ -0,0 +1,11 @@
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  line-height: 1.6;
+  color: #333;
+}

package/templates/minimal/app/layout.tsx

@@ -0,0 +1,22 @@
+import type { ReactElement } from 'react';
+import { DiggoProvider } from '@/components/DiggoProvider';
+import './globals.css';
+
+export const metadata = {
+  title: 'My DiggoCMS App',
+  description: 'Built with DiggoCMS SDK',
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}): ReactElement {
+  return (
+    <html lang="en">
+      <body>
+        <DiggoProvider>{children}</DiggoProvider>
+      </body>
+    </html>
+  );
+}

package/templates/minimal/app/page.tsx

@@ -0,0 +1,6 @@
+import type { ReactElement } from 'react';
+import { redirect } from 'next/navigation';
+
+export default function HomePage(): ReactElement {
+  redirect('/home');
+}

package/templates/minimal/components/DiggoProvider.tsx

@@ -0,0 +1,15 @@
+'use client';
+
+import type { ReactElement, ReactNode } from 'react';
+import { DiggoProvider as SDKProvider } from '@digitalygo/diggocms-sdk-core';
+import { sdkConfig } from '@/lib/diggo-config';
+
+interface DiggoProviderWrapperProps {
+  children: ReactNode;
+}
+
+export function DiggoProvider({
+  children,
+}: DiggoProviderWrapperProps): ReactElement {
+  return <SDKProvider config={sdkConfig}>{children}</SDKProvider>;
+}

package/templates/minimal/lib/data-fetching.ts

@@ -0,0 +1,59 @@
+import type { PagePayload } from '@digitalygo/diggocms-sdk-core';
+import { sdkConfig, isMockMode, hasBaseUrl } from './diggo-config';
+
+export interface FetchPageResult {
+  page: PagePayload | null;
+  error: string | null;
+}
+
+export async function fetchPageData(slug: string): Promise<FetchPageResult> {
+  if (isMockMode()) {
+    // Mock mode: fetch from local mock API
+    try {
+      const mockApiUrl = process.env.MOCK_API_URL ?? 'http://localhost:3001';
+      const response = await fetch(`${mockApiUrl}/pages/${slug}`);
+      
+      if (!response.ok) {
+        return {
+          page: null,
+          error: `Mock API returned ${response.status}`,
+        };
+      }
+      
+      const page = (await response.json()) as PagePayload;
+      return { page, error: null };
+    } catch {
+      return {
+        page: null,
+        error: 'Failed to connect to mock API. Is it running?',
+      };
+    }
+  }
+
+  if (!hasBaseUrl()) {
+    return {
+      page: null,
+      error: 'BASE_URL is not configured and MOCK mode is not enabled.',
+    };
+  }
+
+  // Real API mode: fetch from CMS
+  try {
+    const response = await fetch(`${sdkConfig.baseUrl}/pages/${slug}`);
+    
+    if (!response.ok) {
+      return {
+        page: null,
+        error: `CMS returned ${response.status}`,
+      };
+    }
+    
+    const page = (await response.json()) as PagePayload;
+    return { page, error: null };
+  } catch {
+    return {
+      page: null,
+      error: 'Error connecting to CMS',
+    };
+  }
+}

package/templates/minimal/lib/diggo-config.ts

@@ -0,0 +1,35 @@
+import type { ComponentRegistry, NavigationRegistry, DiggoConfig } from '@digitalygo/diggocms-sdk-core';
+
+// Add your custom components here
+export const componentsRegistry: ComponentRegistry = {
+  // Example: title: ExtendedTitle,
+};
+
+export const navigationRegistry: NavigationRegistry = {
+  // Example: MenuItem: ExtendedMenuItem,
+};
+
+const isMock = process.env.MOCK === '1';
+const baseUrl = process.env.BASE_URL;
+const mockApiUrl = process.env.MOCK_API_URL;
+
+function getBaseUrl(): string {
+  if (isMock) {
+    return mockApiUrl ?? 'http://localhost:3001';
+  }
+  return baseUrl ?? 'http://placeholder.local';
+}
+
+export const sdkConfig: DiggoConfig = {
+  baseUrl: getBaseUrl(),
+  components: componentsRegistry,
+  navigation: navigationRegistry,
+};
+
+export function isMockMode(): boolean {
+  return isMock;
+}
+
+export function hasBaseUrl(): boolean {
+  return !!baseUrl;
+}

package/templates/minimal/next-env.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />

package/templates/minimal/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+};
+
+export default nextConfig;

package/templates/minimal/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "my-diggocms-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@digitalygo/diggocms-sdk-core": "^0.1.0",
+    "next": "^16.0.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "typescript": "^5.5.0"
+  }
+}

package/templates/minimal/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "ES2022"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/with-mock/.env.local.example

@@ -0,0 +1,13 @@
+# DiggoCMS Environment Configuration
+# Copy this file to .env.local and update the values
+
+# CMS API Configuration
+# Set your DiggoCMS API base URL (not needed in mock mode)
+BASE_URL=https://your-cms-api.com
+
+# Mock Mode
+# Set to 1 to use the local mock API server
+MOCK=1
+
+# Mock API URL
+MOCK_API_URL=http://localhost:3001

package/templates/with-mock/README.md

@@ -0,0 +1,128 @@
+# My DiggoCMS App
+
+A complete DiggoCMS application with mock API server for development.
+
+## Features
+
+- Dynamic routing with `[...slug]` pattern
+- Extended components (Title, Subtitle, Image, Richtext, Card)
+- Navigation with dropdown support
+- Built-in mock API server
+- Sample fixtures included
+- Mock mode for development
+- Error handling and loading states
+
+## Quick Start
+
+1. Copy `.env.local.example` to `.env.local`:
+   ```bash
+   cp .env.local.example .env.local
+   ```
+
+2. Install dependencies:
+   ```bash
+   bun install
+   # or
+   npm install
+   ```
+
+3. Start the mock API and dev server:
+   ```bash
+   bun run dev:mock
+   # or run separately:
+   bun run mock:api  # Terminal 1
+   bun run dev       # Terminal 2
+   ```
+
+4. Open [http://localhost:3000](http://localhost:3000) in your browser.
+
+## Available Pages
+
+The mock API includes these sample pages:
+
+- `/` - Home page
+- `/chi-siamo` - About page
+- `/contatti` - Contact page
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `bun run dev` | Start Next.js dev server only |
+| `bun run build` | Build for production |
+| `bun run start` | Start production server |
+| `bun run mock:api` | Start mock API server only |
+| `bun run dev:mock` | Start mock API and dev server together |
+
+## Mock API Endpoints
+
+The mock server provides these endpoints:
+
+- `GET /pages` - List all pages
+- `GET /pages/:slug` - Get page by slug
+- `GET /collections/:type` - Get collection
+- `GET /menus/:key` - Get menu by key
+
+## Project Structure
+
+```
+app/                  # Next.js app router
+├── [...slug]/        # Dynamic catch-all route
+├── layout.tsx        # Root layout with DiggoProvider
+├── page.tsx          # Home redirect
+└── globals.css       # Global styles
+
+components/           # React components
+├── DiggoProvider.tsx
+├── server-components.ts
+├── ExtendedTitle.tsx
+├── ExtendedSubtitle.tsx
+├── ExtendedImage.tsx
+├── ExtendedRichtext.tsx
+├── ExtendedCard.tsx
+├── ExtendedMenuItem.tsx
+└── ExtendedMenuContainer.tsx
+
+lib/                  # Utility functions
+├── diggo-config.ts
+└── data-fetching.ts
+
+fixtures/             # Mock data
+├── pages/
+│   ├── index.json    # Pages list
+│   ├── home.json     # Home page
+│   ├── chi-siamo.json
+│   └── contatti.json
+├── menu.json         # Navigation menu
+└── collection.json   # Sample collection
+
+scripts/
+└── mock-server.ts    # Mock API server
+```
+
+## Switching to Real API
+
+To use a real CMS API instead of mock data:
+
+1. Update `.env.local`:
+   ```env
+   BASE_URL=https://your-cms-api.com
+   MOCK=0
+   ```
+
+2. Restart the dev server:
+   ```bash
+   bun run dev
+   ```
+
+## Customization
+
+1. **Edit fixtures** - Modify files in `fixtures/` to change content
+2. **Add components** - Create new components in `components/` and register in `lib/diggo-config.ts`
+3. **Update styles** - Edit `app/globals.css` or component styles
+4. **Extend mock API** - Add new routes in `scripts/mock-server.ts`
+
+## Documentation
+
+- [DiggoCMS SDK Documentation](https://github.com/digitalygo/diggocms-sdk)
+- [Next.js Documentation](https://nextjs.org/docs)