@nextsparkjs/theme-productivity 0.1.0-beta.1

package/config/app.config.ts

@@ -0,0 +1,172 @@
+/**
+ * Productivity Theme - Application Configuration
+ *
+ * Multi-tenant mode: Multiple workspaces with team switching.
+ * Perfect for teams managing multiple projects or clients.
+ */
+
+export const APP_CONFIG_OVERRIDES = {
+  // =============================================================================
+  // APPLICATION METADATA
+  // =============================================================================
+  app: {
+    name: 'Productivity',
+    version: '1.0.0',
+  },
+
+  // =============================================================================
+  // TEAMS CONFIGURATION - MULTI-TENANT MODE
+  // =============================================================================
+  /**
+   * Multi-tenant mode:
+   * - Multiple work teams (workspaces)
+   * - Team switching enabled
+   * - Invitations enabled
+   * - Can create new teams
+   */
+  teams: {
+    mode: 'multi-tenant' as const,
+    options: {
+      maxMembersPerTeam: 50,
+      allowLeaveTeam: true,
+      allowCreateTeams: true,
+    },
+  },
+
+  // =============================================================================
+  // INTERNATIONALIZATION
+  // =============================================================================
+  i18n: {
+    supportedLocales: ['en', 'es'],
+    defaultLocale: 'en' as const,
+    namespaces: [
+      'common',
+      'dashboard',
+      'settings',
+      'auth',
+      'validation',
+      // Theme specific
+      'boards',
+      'lists',
+      'cards',
+      'productivity',
+    ],
+  },
+
+  // =============================================================================
+  // API CONFIGURATION
+  // =============================================================================
+  api: {
+    cors: {
+      allowedOrigins: {
+        development: [
+          'http://localhost:3000',
+          'http://localhost:5173',
+        ],
+        production: [],
+      },
+    },
+  },
+
+  // =============================================================================
+  // DOCUMENTATION
+  // =============================================================================
+  docs: {
+    enabled: true,
+    public: false, // Private app documentation
+    searchEnabled: true,
+    breadcrumbs: true,
+    theme: {
+      enabled: true,
+      open: true,
+      label: "Productivity Theme",
+    },
+    plugins: {
+      enabled: false,
+      open: false,
+      label: "Plugins",
+    },
+    core: {
+      enabled: true,
+      open: false,
+      label: "Core",
+    },
+    showPluginsDocsInProd: false,
+  },
+
+  // =============================================================================
+  // SCHEDULED ACTIONS
+  // =============================================================================
+  scheduledActions: {
+    enabled: true,
+    retentionDays: 7,
+    batchSize: 10,
+    defaultTimeout: 30000,
+  },
+
+  // =============================================================================
+  // MOBILE NAVIGATION
+  // =============================================================================
+  mobileNav: {
+    items: [
+      {
+        id: 'home',
+        labelKey: 'common.mobileNav.home',
+        href: '/dashboard',
+        icon: 'Home',
+        enabled: true,
+      },
+      {
+        id: 'boards',
+        labelKey: 'boards.title',
+        href: '/dashboard/boards',
+        icon: 'LayoutDashboard',
+        enabled: true,
+      },
+      {
+        id: 'create',
+        labelKey: 'common.mobileNav.create',
+        icon: 'Plus',
+        isCentral: true,
+        action: 'quickCreate',
+        enabled: true,
+      },
+      {
+        id: 'cards',
+        labelKey: 'cards.myCards',
+        href: '/dashboard/cards',
+        icon: 'CreditCard',
+        enabled: true,
+      },
+      {
+        id: 'settings',
+        labelKey: 'common.mobileNav.settings',
+        href: '/dashboard/settings',
+        icon: 'Settings',
+        enabled: true,
+      },
+    ],
+    moreSheetItems: [
+      {
+        id: 'profile',
+        labelKey: 'common.navigation.profile',
+        href: '/dashboard/settings/profile',
+        icon: 'User',
+        enabled: true,
+      },
+      {
+        id: 'team',
+        labelKey: 'common.navigation.team',
+        href: '/dashboard/settings/teams',
+        icon: 'Users',
+        enabled: true,
+      },
+    ],
+  },
+
+  // =============================================================================
+  // DEV KEYRING - MOVED TO dev.config.ts
+  // =============================================================================
+  // DevKeyring configuration has been moved to config/dev.config.ts
+  // This separates development-only settings from production configuration.
+}

package/config/billing.config.ts

@@ -0,0 +1,187 @@
+/**
+ * Billing Configuration - Productivity Theme
+ *
+ * Defines plans, features, limits, and action mappings for the Productivity theme.
+ * Customized for project and task management.
+ */
+
+import type { BillingConfig } from '@nextsparkjs/core/lib/billing/config-types'
+
+export const billingConfig: BillingConfig = {
+  provider: 'stripe',
+  currency: 'usd',
+  defaultPlan: 'free',
+
+  // ===========================================
+  // FEATURE DEFINITIONS (Productivity-specific)
+  // ===========================================
+  features: {
+    basic_analytics: {
+      name: 'billing.features.basic_analytics',
+      description: 'billing.features.basic_analytics_description',
+    },
+    advanced_analytics: {
+      name: 'billing.features.advanced_analytics',
+      description: 'billing.features.advanced_analytics_description',
+    },
+    api_access: {
+      name: 'billing.features.api_access',
+      description: 'billing.features.api_access_description',
+    },
+    custom_branding: {
+      name: 'billing.features.custom_branding',
+      description: 'billing.features.custom_branding_description',
+    },
+    gantt_view: {
+      name: 'billing.features.gantt_view',
+      description: 'billing.features.gantt_view_description',
+    },
+    time_tracking: {
+      name: 'billing.features.time_tracking',
+      description: 'billing.features.time_tracking_description',
+    },
+    priority_support: {
+      name: 'billing.features.priority_support',
+      description: 'billing.features.priority_support_description',
+    },
+  },
+
+  // ===========================================
+  // LIMIT DEFINITIONS (Productivity-specific)
+  // ===========================================
+  limits: {
+    team_members: {
+      name: 'billing.limits.team_members',
+      unit: 'count',
+      resetPeriod: 'never',
+    },
+    projects: {
+      name: 'billing.limits.projects',
+      unit: 'count',
+      resetPeriod: 'never',
+    },
+    tasks: {
+      name: 'billing.limits.tasks',
+      unit: 'count',
+      resetPeriod: 'never',
+    },
+    workspaces: {
+      name: 'billing.limits.workspaces',
+      unit: 'count',
+      resetPeriod: 'never',
+    },
+    api_calls: {
+      name: 'billing.limits.api_calls',
+      unit: 'calls',
+      resetPeriod: 'monthly',
+    },
+    storage_gb: {
+      name: 'billing.limits.storage',
+      unit: 'bytes',
+      resetPeriod: 'never',
+    },
+  },
+
+  // ===========================================
+  // PLAN DEFINITIONS (Productivity-optimized)
+  // ===========================================
+  plans: [
+    {
+      slug: 'free',
+      name: 'billing.plans.free.name',
+      description: 'billing.plans.free.description',
+      type: 'free',
+      visibility: 'public',
+      price: { monthly: 0, yearly: 0 },
+      trialDays: 0,
+      features: ['basic_analytics'],
+      limits: {
+        team_members: 3,
+        projects: 5,
+        tasks: 100,
+        workspaces: 1,
+        api_calls: 1000,
+        storage_gb: 2,
+      },
+      stripePriceIdMonthly: null,
+      stripePriceIdYearly: null,
+    },
+    {
+      slug: 'pro',
+      name: 'billing.plans.pro.name',
+      description: 'billing.plans.pro.description',
+      type: 'paid',
+      visibility: 'public',
+      price: {
+        monthly: 2900,  // $29.00 - Same as default theme
+        yearly: 29000,  // $290.00 (16% savings)
+      },
+      trialDays: 14,
+      features: [
+        'basic_analytics',
+        'advanced_analytics',
+        'api_access',
+        'gantt_view',
+        'time_tracking',
+      ],
+      limits: {
+        team_members: 15,
+        projects: 100,
+        tasks: -1,  // Unlimited tasks
+        workspaces: 5,
+        api_calls: 100000,
+        storage_gb: 50,
+      },
+      // Configure these in Stripe Dashboard
+      stripePriceIdMonthly: 'price_productivity_pro_monthly',
+      stripePriceIdYearly: 'price_productivity_pro_yearly',
+    },
+    {
+      slug: 'enterprise',
+      name: 'billing.plans.enterprise.name',
+      description: 'billing.plans.enterprise.description',
+      type: 'enterprise',
+      visibility: 'hidden',
+      trialDays: 30,
+      features: ['*'],  // All features
+      limits: {
+        team_members: -1,  // Unlimited
+        projects: -1,
+        tasks: -1,
+        workspaces: -1,
+        api_calls: -1,
+        storage_gb: -1,
+      },
+      stripePriceIdMonthly: null,
+      stripePriceIdYearly: null,
+    },
+  ],
+
+  // ===========================================
+  // ACTION MAPPINGS (Productivity-specific)
+  // ===========================================
+  actionMappings: {
+    permissions: {
+      'team.members.invite': 'team.members.invite',
+      'team.settings.edit': 'team.settings.edit',
+      'team.billing.manage': 'team.billing.manage',
+    },
+
+    features: {
+      'analytics.view_advanced': 'advanced_analytics',
+      'api.generate_key': 'api_access',
+      'project.gantt_view': 'gantt_view',
+      'task.time_tracking': 'time_tracking',
+      'support.priority_access': 'priority_support',
+    },
+
+    limits: {
+      'team.members.invite': 'team_members',
+      'projects.create': 'projects',
+      'tasks.create': 'tasks',
+      'workspaces.create': 'workspaces',
+      'api.call': 'api_calls',
+      'files.upload': 'storage_gb',
+    },
+  },
+}

package/config/dashboard.config.ts

@@ -0,0 +1,357 @@
+/**
+ * Productivity Theme - Dashboard Configuration
+ *
+ * Board-centric dashboard for task management.
+ */
+
+export const DASHBOARD_CONFIG = {
+  // =============================================================================
+  // TOPBAR CONFIGURATION
+  // =============================================================================
+  topbar: {
+    search: {
+      enabled: true,
+      placeholder: 'dashboard.search.placeholder',
+      maxResults: 10,
+    },
+    notifications: {
+      enabled: true, // Notifications for assigned cards, mentions
+    },
+    themeToggle: {
+      enabled: true,
+    },
+    support: {
+      enabled: true,
+      type: 'dropdown',
+      links: [
+        {
+          label: 'common.help.documentation',
+          url: '/docs',
+          icon: 'book-open',
+          external: false,
+        },
+        {
+          label: 'common.help.keyboard',
+          action: 'showKeyboardShortcuts',
+          icon: 'keyboard',
+        }
+      ],
+    },
+    quickCreate: {
+      enabled: true,
+    },
+    /**
+     * Admin access button (Super Admin area)
+     */
+    adminAccess: {
+      enabled: true,
+      showToDevelopers: true,
+    },
+    /**
+     * Dev Zone access button (Developer area)
+     */
+    devtoolsAccess: {
+      enabled: true,
+    },
+    userMenu: {
+      enabled: true,
+      showAvatar: true,
+      showEmail: true,
+      showRole: false,
+      items: [
+        { type: 'link', label: 'navigation.profile', href: '/dashboard/settings/profile', icon: 'user' },
+        { type: 'link', label: 'navigation.team', href: '/dashboard/settings/teams', icon: 'users' },
+        { type: 'link', label: 'navigation.settings', href: '/dashboard/settings', icon: 'settings' },
+        { type: 'divider' },
+        { type: 'action', label: 'buttons.signOut', action: 'signOut', icon: 'log-out' },
+      ],
+    },
+  },
+
+  // =============================================================================
+  // SIDEBAR CONFIGURATION
+  // =============================================================================
+  sidebar: {
+    defaultCollapsed: false,
+    rememberState: true,
+    collapsedWidth: '60px',
+    expandedWidth: '260px',
+    toggle: {
+      enabled: true,
+      showInTopbar: true,
+      hideOnMobile: false,
+    },
+    navigation: {
+      showEntityCounts: true,
+      groupEntities: true,
+      showRecents: true,
+      maxRecents: 5,
+    },
+  },
+
+  // =============================================================================
+  // SETTINGS PAGES
+  // =============================================================================
+  settings: {
+    pages: {
+      profile: {
+        enabled: true,
+        label: 'settings.pages.profile',
+        description: 'settings.pages.profileDescription',
+        icon: 'user',
+        order: 1,
+        features: {
+          avatarUpload: true,
+          nameChange: true,
+          emailChange: true,
+          localeChange: true,
+          timezoneChange: true,
+        },
+      },
+      security: {
+        enabled: true,
+        label: 'settings.pages.security',
+        description: 'settings.pages.securityDescription',
+        icon: 'shield',
+        order: 2,
+        features: {
+          twoFactorAuth: true,
+          sessionManagement: true,
+          loginHistory: true,
+          securityQuestions: false,
+        },
+      },
+      password: {
+        enabled: true,
+        label: 'settings.pages.password',
+        description: 'settings.pages.passwordDescription',
+        icon: 'key',
+        order: 3,
+        features: {
+          passwordChange: true,
+          passwordStrength: true,
+          passwordHistory: false,
+        },
+      },
+      notifications: {
+        enabled: true,
+        label: 'settings.pages.notifications',
+        description: 'settings.pages.notificationsDescription',
+        icon: 'bell',
+        order: 4,
+        features: {
+          emailNotifications: true,
+          pushNotifications: true,
+          smsNotifications: false,
+          notificationCategories: true,
+        },
+      },
+      'api-keys': {
+        enabled: false, // Not needed for this app
+        label: 'settings.pages.apiKeys',
+        description: 'settings.pages.apiKeysDescription',
+        icon: 'key',
+        order: 5,
+        features: {},
+      },
+      billing: {
+        enabled: true,
+        label: 'settings.pages.billing',
+        description: 'settings.pages.billingDescription',
+        icon: 'credit-card',
+        order: 6,
+        features: {},
+      },
+      teams: {
+        enabled: true, // Team management for multi-tenant mode
+        label: 'settings.pages.teams',
+        description: 'settings.pages.teamsDescription',
+        icon: 'users',
+        order: 7,
+        features: {
+          createTeams: true, // Can create new teams in multi-tenant mode
+          manageMembers: true,
+          inviteMembers: true,
+          teamSettings: true,
+        },
+      },
+      plans: {
+        enabled: true,
+        label: 'settings.pages.plans',
+        description: 'settings.pages.plansDescription',
+        icon: 'credit-card',
+        order: 8,
+        features: {
+          planComparison: true,
+          planSelection: true,
+        },
+      },
+    },
+    layout: {
+      showDescription: true,
+      showIcons: true,
+      groupByCategory: false,
+      enableSearch: true,
+    },
+  },
+
+  // =============================================================================
+  // ENTITY PAGES
+  // =============================================================================
+  entities: {
+    defaultListView: {
+      pagination: {
+        defaultPageSize: 20,
+        allowedPageSizes: [10, 20, 50],
+        showSizeSelector: true,
+      },
+      sorting: {
+        enabled: true,
+        defaultSort: { field: 'position', direction: 'asc' },
+        rememberSort: true,
+      },
+      filtering: {
+        enabled: true,
+        quickFilters: true,
+        advancedFilters: true,
+        rememberFilters: true,
+      },
+      search: {
+        enabled: true,
+        placeholder: 'dashboard.entities.searchPlaceholder',
+        searchableFields: ['name', 'title', 'description'],
+        instantSearch: true,
+        debounceMs: 200,
+      },
+    },
+    defaultFormView: {
+      validation: {
+        validateOnBlur: true,
+        validateOnChange: false,
+        showFieldErrors: true,
+        showFormErrors: true,
+      },
+      autosave: {
+        enabled: false,
+        intervalMs: 30000,
+        showIndicator: true,
+      },
+      confirmation: {
+        showOnCreate: false,
+        showOnUpdate: false,
+        showOnDelete: true,
+      },
+    },
+    customizations: {
+      boards: {
+        listView: {
+          defaultSort: { field: 'position', direction: 'asc' },
+        },
+      },
+      lists: {
+        listView: {
+          defaultSort: { field: 'position', direction: 'asc' },
+        },
+      },
+      cards: {
+        listView: {
+          defaultSort: { field: 'position', direction: 'asc' },
+          quickFilters: ['listId', 'assigneeId', 'dueDate'],
+        },
+      },
+    },
+  },
+
+  // =============================================================================
+  // DASHBOARD HOMEPAGE
+  // =============================================================================
+  homepage: {
+    widgets: {
+      welcome: {
+        enabled: true,
+        showUserName: true,
+        showLastLogin: false,
+        showQuickActions: true,
+      },
+      stats: {
+        enabled: true,
+        entities: ['boards', 'cards'],
+        timeframe: '7days',
+        showTrends: true,
+      },
+      recentActivity: {
+        enabled: true,
+        maxItems: 10,
+        entities: ['boards', 'cards'],
+        showTimestamps: true,
+      },
+      quickActions: {
+        enabled: true,
+        actions: [
+          { entity: 'boards', action: 'create', label: 'productivity.quickActions.createBoard' },
+          { entity: 'cards', action: 'create', label: 'productivity.quickActions.createCard' },
+        ],
+      },
+    },
+    layout: {
+      columns: 3,
+      gutter: 'medium',
+      responsive: true,
+    },
+  },
+
+  // =============================================================================
+  // PERFORMANCE
+  // =============================================================================
+  performance: {
+    cache: {
+      entityConfigs: { enabled: true, duration: 5 * 60 * 1000 },
+      entityData: { enabled: true, duration: 1 * 60 * 1000 }, // Shorter cache for real-time feel
+    },
+    loading: {
+      showSkeletons: true,
+      showProgressBars: true,
+      minimumLoadingTime: 150,
+    },
+    errors: {
+      showErrorBoundaries: true,
+      logErrors: true,
+      enableRetry: true,
+      maxRetries: 3,
+    },
+  },
+
+  // =============================================================================
+  // ACCESSIBILITY
+  // =============================================================================
+  accessibility: {
+    keyboard: {
+      enabled: true,
+      showShortcuts: true,
+      customShortcuts: {
+        'Ctrl+K': 'openSearch',
+        'Ctrl+Shift+N': 'quickCreate',
+        'Ctrl+B': 'toggleSidebar',
+        'Esc': 'closeModals',
+        'N': 'newCard',
+        'B': 'newBoard',
+      },
+    },
+    screenReader: {
+      announceNavigation: true,
+      announceActions: true,
+      announceErrors: true,
+    },
+    visual: {
+      showFocusOutlines: true,
+      highContrastMode: false,
+      reducedMotion: false,
+    },
+  },
+} as const
+
+export const TOPBAR_CONFIG = DASHBOARD_CONFIG.topbar
+export const SIDEBAR_CONFIG = DASHBOARD_CONFIG.sidebar
+export const SETTINGS_CONFIG = DASHBOARD_CONFIG.settings
+export const ENTITIES_CONFIG = DASHBOARD_CONFIG.entities
+export const HOMEPAGE_CONFIG = DASHBOARD_CONFIG.homepage