@cellajs/create-cella 0.2.0 → 0.2.2

package/configs/default-config.ts.template

@@ -0,0 +1,378 @@
+/**
+ * Placeholder default config for new forks created by `create-cella`.
+ *
+ * This file replaces `shared/config/config.default.ts` during project creation.
+ * Tokens `__project_name__` and `__project_slug__` are interpolated with the
+ * project name chosen by the user. All Cella-specific branding, URLs, tokens
+ * and company details are replaced with safe placeholder values.
+ *
+ * NOTE: This file is NOT compiled or imported — it is copied and interpolated
+ * as plain text. The import path below is relative to `shared/config/` (its destination).
+ */
+import type { ConfigMode, RequiredConfig, S3ConfigInput } from '../src/config-builder/types';
+
+// Re-export for external consumers
+export { roles, hierarchy } from './hierarchy-config';
+
+export const config = {
+
+  /******************************************************************************
+   * ENTITY DATA MODEL
+   ******************************************************************************/
+
+  /** All entity types in the app - must match hierarchy.allTypes. */
+  entityTypes: ['user', 'organization', 'attachment', 'page'] as const,
+
+  /** Context entities with memberships - must match hierarchy.contextTypes. */
+  contextEntityTypes: ['organization'] as const,
+
+  /** Product/content entities - must match hierarchy.productTypes. */
+  productEntityTypes: ['attachment', 'page'] as const,
+
+  /**
+   * Product entity types tracked for seen/unseen counts.
+   * Unseen counts are grouped by the parent context entity of each tracked type.
+   */
+  seenTrackedEntityTypes: ['attachment'] as const,
+
+  /** Maps entity types to their ID column names - must match entityTypes */
+  entityIdColumnKeys: {
+    user: 'userId',
+    organization: 'organizationId',
+    attachment: 'attachmentId',
+    page: 'pageId',
+  } as const,
+
+  /** Available CRUD actions for permission checks */
+  entityActions: ['create', 'read', 'update', 'delete'] as const,
+
+  /** Resource types that are not entities but have activities logged */
+  resourceTypes: ['request', 'membership', 'inactive_membership', 'tenant'] as const,
+
+  /**
+   * Entity embeddings: declares which entities are embedded as ID arrays inside
+   * other entities. Forks extend when adding new embedding relationships.
+   */
+  entityEmbeddings: [] as readonly { readonly embeddedEntity: string; readonly hostEntity: string; readonly hostColumn: string }[],
+
+  /**
+   * User menu structure of context entities with optional nested subentities.
+   * If subentityType is set, the table must include `${entity}Id` foreign key.
+   */
+  menuStructure: [
+    { entityType: 'organization', subentityType: null } as const,
+  ],
+
+  /** Default restrictions for tenants (entity quotas and rate limits) */
+  defaultRestrictions: {
+    quotas: {
+      organization: 5,
+      user: 1000,
+      attachment: 100,
+    },
+    rateLimits: {
+      apiPointsPerHour: 1000,
+    },
+  } as const,
+
+  /******************************************************************************
+   * SYSTEM ROLES
+   ******************************************************************************/
+
+  systemRoles: ['admin'] as const,
+
+  /******************************************************************************
+   * APP IDENTITY
+   ******************************************************************************/
+
+  /** App display name shown in UI and emails */
+  name: '__project_name__',
+  /** URL-safe identifier used in paths and storage */
+  slug: '__project_slug__',
+  /** Primary domain for the app */
+  domain: '__project_slug__.example.com',
+  /** App description for SEO and meta tags */
+  description: '__project_name__ — powered by Cella.',
+  /** SEO keywords for search engines */
+  keywords:
+    'starter kit, fullstack, monorepo, typescript, hono, honojs, drizzle, baseui, react, postgres, pwa, offline, instant updates, realtime data, sync engine',
+
+  /******************************************************************************
+   * URLS & ENDPOINTS
+   ******************************************************************************/
+
+  /** Frontend SPA base URL */
+  frontendUrl: 'https://__project_slug__.example.com',
+  /** Backend API base URL */
+  backendUrl: 'https://api.__project_slug__.example.com',
+  /** OAuth callback base URL */
+  backendAuthUrl: 'https://api.__project_slug__.example.com/auth',
+  /** Yjs realtime relay URL */
+  yjsUrl: 'wss://yjs.__project_slug__.example.com',
+  /** AI service base URL */
+  aiUrl: 'https://ai.__project_slug__.example.com',
+
+  /** About page URL */
+  aboutUrl: '/about',
+  /** Status page URL for uptime monitoring */
+  statusUrl: 'https://status.__project_slug__.example.com',
+  /** Canonical production URL */
+  productionUrl: 'https://__project_slug__.example.com',
+
+  /** Default redirect path after login */
+  defaultRedirectPath: '/home',
+  /** Redirect path for first-time users */
+  welcomeRedirectPath: '/welcome',
+
+  /******************************************************************************
+   * EMAIL
+   ******************************************************************************/
+
+  /** From address for system notifications */
+  senderEmail: 'notifications@__project_slug__.example.com',
+  /** Email address for user support inquiries */
+  supportEmail: 'support@__project_slug__.example.com',
+  /** Receive security warnings */
+  securityEmail: 'security@__project_slug__.example.com',
+
+  /******************************************************************************
+   * MODE & FLAGS
+   ******************************************************************************/
+
+  /** Runtime mode - overridden per environment file */
+  mode: 'development' as ConfigMode,
+  /** Enable maintenance mode (blocks all requests) */
+  maintenance: false,
+  /** Cookie version - increment when changing cookie structure to invalidate old cookies */
+  cookieVersion: 'v1',
+
+  /******************************************************************************
+   * FEATURE FLAGS
+   ******************************************************************************/
+
+  /**
+   * Feature toggles for app capabilities.
+   * Use to enable/disable major features without code changes.
+   */
+  has: {
+    /** Progressive Web App support for preloading static assets and offline support */
+    pwa: true as boolean,
+    /** Allow users to sign up. If false, the app is by invitation only */
+    selfRegistration: false as boolean,
+    /** Suggest a waitlist for unknown emails when sign up is disabled */
+    waitlist: false as boolean,
+    /** S3 fully configured - if false, files will be stored in local browser (IndexedDB) */
+    uploadEnabled: false as boolean,
+    /** Customer support chat widget (Gleap). Unrelated to the AI module. */
+    chatSupport: false as boolean,
+    /** Yjs realtime collaboration */
+    yjs: false as boolean,
+    /** AI capability layer: tool registry + model runner + MCP endpoint. */
+    ai: false as boolean,
+  },
+
+  /******************************************************************************
+   * AUTHENTICATION
+   ******************************************************************************/
+
+  /**
+   * Enabled authentication strategies.
+   * TOTP can only be used as MFA fallback with passkey as primary.
+   */
+  enabledAuthStrategies: ['passkey', 'oauth', 'totp', 'magic'] as const,
+
+  /** Enabled OAuth providers - currently supports: github, google, microsoft */
+  enabledOAuthProviders: ['github'] as const,
+
+  /** Token types used for verification flows */
+  tokenTypes: ['email-verification', 'oauth-verification', 'invitation', 'confirm-mfa', 'magic'] as const,
+
+  /** TOTP configuration for MFA */
+  totpConfig: {
+    intervalInSeconds: 30,
+    gracePeriodInSeconds: 60,
+    digits: 6,
+  },
+
+  /******************************************************************************
+   * API CONFIGURATION
+   ******************************************************************************/
+
+  /** API version prefix for endpoints */
+  apiVersion: 'v1',
+  /** API documentation description shown in Scalar */
+  apiDescription: `⚠️ ATTENTION: PRERELEASE!
+                  This API is organized into modules based on logical domains.`,
+
+  /******************************************************************************
+   * REQUEST LIMITS
+   ******************************************************************************/
+
+  /**
+   * Default page sizes for list endpoints. Backend enforces max 1000.
+   * Must include 'default' key as fallback.
+   */
+  requestLimits: {
+    default: 40,
+    users: 100,
+    members: 40,
+    organizations: 40,
+    requests: 40,
+    attachments: 40,
+    pages: 100,
+    pendingMemberships: 20,
+  },
+
+  /** Max JSON body size in bytes */
+  jsonBodyLimit: 1 * 1024 * 1024,
+  /** Max file upload size in bytes */
+  fileUploadLimit: 20 * 1024 * 1024,
+  /** Default body size limit in bytes */
+  defaultBodyLimit: 1 * 1024 * 1024,
+
+  /******************************************************************************
+   * STORAGE & UPLOADS (S3)
+   ******************************************************************************/
+
+  /** S3-compatible storage configuration. Only region and host are required; the rest is derived from the slug. */
+  s3: {
+    region: '',
+    host: '',
+  } as S3ConfigInput,
+
+  /** Upload template IDs for Transloadit processing pipelines */
+  uploadTemplateIds: ['avatar', 'cover', 'attachment'] as const,
+
+  /** Uppy upload widget default restrictions */
+  uppy: {
+    defaultRestrictions: {
+      maxFileSize: 10 * 1024 * 1024,
+      maxNumberOfFiles: 1,
+      allowedFileTypes: ['.jpg', '.jpeg', '.png'],
+      maxTotalFileSize: 100 * 1024 * 1024,
+      minFileSize: null,
+      minNumberOfFiles: null,
+      requiredMetaFields: [],
+    },
+  },
+
+  /**
+   * Local blob storage restrictions (IndexedDB/Dexie).
+   * Controls which attachments are cached locally for offline access.
+   */
+  localBlobStorage: {
+    enabled: true,
+    maxFileSize: 10 * 1024 * 1024,
+    maxTotalSize: 100 * 1024 * 1024,
+    allowedContentTypes: [] as string[],
+    excludedContentTypes: ['video/*'] as string[],
+    downloadConcurrency: 2,
+    uploadRetryAttempts: 3,
+    uploadRetryDelays: [60000, 300000, 900000] as const,
+  },
+
+  /******************************************************************************
+   * THIRD-PARTY SERVICES
+   ******************************************************************************/
+
+  /** Gleap token for customer support widget */
+  gleapToken: '',
+  /** Google Maps API key */
+  googleMapsKey: '',
+  /** Matrix homeserver URL for chat integration */
+  matrixURL: 'https://matrix-client.matrix.org',
+
+  /******************************************************************************
+   * THEMING & UI
+   ******************************************************************************/
+
+  /** Primary theme color for PWA manifest and browser chrome */
+  themeColor: '#26262b',
+  /** Theme configuration for UI components */
+  theme: {
+    navigation: {
+      hasSidebarTextLabels: false,
+      sidebarWidthExpanded: '16rem',
+      sidebarWidthCollapsed: '4rem',
+      sheetPanelWidth: '20rem',
+    },
+    colors: {},
+    strokeWidth: 1.5,
+    screenSizes: {
+      xs: '420px',
+      sm: '640px',
+      md: '768px',
+      lg: '1024px',
+      xl: '1280px',
+      '2xl': '1400px',
+    },
+  } as const,
+  /** Placeholder background colors for avatars without images */
+  placeholderColors: [
+    'bg-blue-300',
+    'bg-lime-300',
+    'bg-orange-300',
+    'bg-yellow-300',
+    'bg-green-300',
+    'bg-teal-300',
+    'bg-indigo-300',
+    'bg-purple-300',
+    'bg-pink-300',
+    'bg-red-300',
+  ],
+
+  /******************************************************************************
+   * LOCALIZATION
+   ******************************************************************************/
+
+  /** Default language code */
+  defaultLanguage: 'en' as const,
+  /** Available language codes - first is fallback */
+  languages: ['en', 'nl'] as const,
+  /** Common reference data */
+  c: {
+    countries: ['fr', 'de', 'nl', 'ua', 'us', 'gb'],
+    timezones: [],
+  },
+
+  /******************************************************************************
+   * COMPANY DETAILS
+   ******************************************************************************/
+
+  /** Company/organization details for footer, legal pages, and contact info */
+  company: {
+    name: '__project_name__',
+    shortName: '__project_name__',
+    email: 'info@__project_slug__.example.com',
+    supportEmail: 'support@__project_slug__.example.com',
+    tel: '',
+    streetAddress: '',
+    postcode: '',
+    city: '',
+    country: '',
+    registration: '',
+    bankAccount: '',
+    googleMapsUrl: '',
+    scheduleCallUrl: '',
+    blueskyUrl: '',
+    blueskyHandle: '',
+    element: '',
+    githubUrl: '',
+    mapZoom: 4,
+    coordinates: {
+      lat: 0,
+      lng: 0,
+    },
+  },
+
+  /******************************************************************************
+   * USER DEFAULTS
+   ******************************************************************************/
+
+  /** Default user flags applied to new users */
+  defaultUserFlags: {
+    finishedOnboarding: false,
+  },
+} satisfies RequiredConfig;
+
+export default config;