@umituz/react-native-settings 4.20.60 → 4.20.62

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-settings",
-  "version": "4.20.60",
+  "version": "4.20.62",
   "description": "Complete settings hub for React Native apps - consolidated package with settings, about, legal, appearance, feedback, FAQs, and rating",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -26,6 +26,8 @@
     "feedback",
     "faqs",
     "rating",
+    "gamification",
+    "achievements",
     "consolidated"
   ],
   "author": "Ümit UZ <umit@umituz.com>",
@@ -38,6 +40,7 @@
     "@react-native-async-storage/async-storage": "^2.2.0",
     "@umituz/react-native-auth": "latest",
     "@umituz/react-native-design-system": "latest",
+    "@umituz/react-native-gamification": "latest",
     "@umituz/react-native-localization": "latest",
     "@umituz/react-native-notifications": "latest",
     "@umituz/react-native-onboarding": "latest",

package/src/domains/gamification/README.md

@@ -0,0 +1,343 @@
+# Gamification Domain
+
+Complete gamification integration for React Native Settings package.
+
+## Overview
+
+The gamification domain provides a seamless integration of achievements, levels, streaks, and points into your settings screen. It wraps `@umituz/react-native-gamification` with settings-specific functionality.
+
+## Features
+
+- ✅ **Achievements System** - Track and display user achievements
+- ✅ **Level Progression** - Visual level progress with points
+- ✅ **Streak Tracking** - Daily streak monitoring
+- ✅ **Statistics Display** - Comprehensive stats cards
+- ✅ **Localized** - Full i18n support via `@umituz/react-native-localization`
+- ✅ **Theme Support** - Automatic dark/light mode integration
+- ✅ **Navigation Ready** - Pre-configured navigation integration
+
+## Architecture
+
+```
+src/domains/gamification/
+├── types/
+│   └── index.ts                    # Type definitions
+├── components/
+│   ├── GamificationScreenWrapper.tsx   # Main screen wrapper
+│   └── GamificationSettingsItem.tsx    # Menu item component
+└── index.ts                        # Public API
+```
+
+## Installation
+
+The gamification domain is included in `@umituz/react-native-settings`. Ensure you have the peer dependency:
+
+```bash
+npm install @umituz/react-native-gamification
+```
+
+## Usage
+
+### 1. Configure Gamification in Settings
+
+```typescript
+// src/domains/settings/config/gamification.config.ts
+import type { GamificationSettingsConfig } from "@umituz/react-native-settings";
+
+export const createGamificationConfig = ({ t }): GamificationSettingsConfig => ({
+  enabled: true,
+  config: {
+    storageKey: "app_gamification",
+    achievements: [
+      { id: "first_task", threshold: 1, type: "count" },
+      { id: "ten_tasks", threshold: 10, type: "count" },
+      { id: "week_streak", threshold: 7, type: "streak" },
+    ],
+    levels: [
+      { level: 1, minPoints: 0, maxPoints: 50 },
+      { level: 2, minPoints: 50, maxPoints: 150 },
+      { level: 3, minPoints: 150, maxPoints: 300 },
+    ],
+    pointsPerAction: 10,
+    streakBonusMultiplier: 1.5,
+  },
+  screenProps: {
+    title: t("gamification.title"),
+    statsTitle: t("gamification.stats.title"),
+    achievementsTitle: t("gamification.achievements.title"),
+    streakTitle: t("gamification.streak.title"),
+  },
+});
+```
+
+### 2. Add to Settings Config
+
+```typescript
+// src/domains/settings/config/settings.config.ts
+import { createGamificationConfig } from "./gamification.config";
+
+export const createSettingsConfig = ({ t, user, isPremium }) => ({
+  // ... other configs
+  gamification: createGamificationConfig({ t }),
+});
+```
+
+### 3. Pass to SettingsStackNavigator
+
+```typescript
+// src/domains/settings/presentation/SettingsTab.tsx
+import { SettingsStackNavigator } from "@umituz/react-native-settings";
+
+export const SettingsTab = () => {
+  const { t } = useLocalization();
+  const config = useMemo(() => createSettingsConfig({ t }), [t]);
+
+  return (
+    <SettingsStackNavigator
+      appInfo={APP_INFO}
+      legalUrls={LEGAL_URLS}
+      gamificationConfig={config.gamification}
+    />
+  );
+};
+```
+
+### 4. Add Menu Item (Optional)
+
+```typescript
+// In your custom settings sections
+import { GamificationSettingsItem } from "@umituz/react-native-settings";
+
+const customSections = [
+  {
+    title: t("settings.sections.engagement"),
+    items: [
+      <GamificationSettingsItem
+        config={{
+          enabled: true,
+          title: t("settings.gamification.menuTitle"),
+          subtitle: t("settings.gamification.menuSubtitle"),
+          icon: "trophy",
+          onPress: () => navigation.navigate("Gamification"),
+        }}
+      />,
+    ],
+  },
+];
+```
+
+## Localization
+
+Add these keys to your localization files:
+
+```json
+{
+  "settings": {
+    "gamification": {
+      "title": "Achievements",
+      "menuTitle": "Achievements & Progress",
+      "menuSubtitle": "View your achievements and stats"
+    }
+  },
+  "gamification": {
+    "title": "Your Progress",
+    "level": {
+      "title": "Level {{level}}"
+    },
+    "stats": {
+      "title": "Statistics",
+      "totalPoints": "Total Points",
+      "tasksCompleted": "Tasks Completed",
+      "achievementsUnlocked": "Achievements"
+    },
+    "achievements": {
+      "title": "Achievements",
+      "empty": "No achievements yet. Keep going!",
+      "first_task": {
+        "title": "First Steps",
+        "description": "Complete your first task"
+      },
+      "ten_tasks": {
+        "title": "Getting Started",
+        "description": "Complete 10 tasks"
+      },
+      "week_streak": {
+        "title": "Week Warrior",
+        "description": "Maintain a 7-day streak"
+      }
+    },
+    "streak": {
+      "title": "Streak",
+      "current": "Current Streak",
+      "best": "Best Streak"
+    }
+  }
+}
+```
+
+## API Reference
+
+### Types
+
+#### `GamificationSettingsConfig`
+
+```typescript
+interface GamificationSettingsConfig {
+  enabled: boolean;
+  config: GamificationConfig;
+  screenProps: Omit<GamificationScreenProps, "levelProps" | "stats" | "achievements">;
+  onNavigate?: () => void;
+}
+```
+
+#### `GamificationMenuConfig`
+
+```typescript
+interface GamificationMenuConfig {
+  enabled: boolean;
+  title: string;
+  subtitle?: string;
+  icon?: string;
+  onPress?: () => void;
+}
+```
+
+### Components
+
+#### `GamificationScreenWrapper`
+
+Main screen component that displays gamification data.
+
+**Props:**
+- `config: GamificationSettingsConfig` - Configuration object
+
+#### `GamificationSettingsItem`
+
+Menu item component for settings list.
+
+**Props:**
+- `config: GamificationMenuConfig` - Menu configuration
+
+## Re-exported Components
+
+All components from `@umituz/react-native-gamification` are re-exported for convenience:
+
+```typescript
+import {
+  LevelProgress,
+  PointsBadge,
+  AchievementCard,
+  AchievementToast,
+  StreakDisplay,
+  StatsCard,
+  AchievementItem,
+  useGamification,
+  useGamificationStore,
+} from "@umituz/react-native-settings";
+```
+
+## Example: Complete Integration
+
+```typescript
+// 1. Create config
+const gamificationConfig: GamificationSettingsConfig = {
+  enabled: true,
+  config: {
+    storageKey: "my_app_gamification",
+    achievements: [
+      { id: "first_login", threshold: 1, type: "milestone" },
+      { id: "power_user", threshold: 100, type: "count" },
+    ],
+    levels: [
+      { level: 1, minPoints: 0, maxPoints: 100 },
+      { level: 2, minPoints: 100, maxPoints: 250 },
+    ],
+    pointsPerAction: 5,
+  },
+  screenProps: {
+    title: "Your Achievements",
+    statsTitle: "Your Stats",
+    achievementsTitle: "Unlocked Achievements",
+    streakTitle: "Daily Streak",
+  },
+};
+
+// 2. Use in navigator
+<SettingsStackNavigator
+  appInfo={APP_INFO}
+  legalUrls={LEGAL_URLS}
+  gamificationConfig={gamificationConfig}
+/>
+
+// 3. Track actions in your app
+import { useGamification } from "@umituz/react-native-settings";
+
+const MyComponent = () => {
+  const { completeTask, addPoints } = useGamification();
+
+  const handleTaskComplete = () => {
+    completeTask(); // Adds points, updates streak, checks achievements
+  };
+
+  return <Button onPress={handleTaskComplete} title="Complete Task" />;
+};
+```
+
+## Best Practices
+
+1. **Config Files ≤ 80 lines** - Keep gamification config in separate file
+2. **Use i18n** - Never hardcode strings, always use translation keys
+3. **Initialize Early** - Initialize gamification in app startup
+4. **Track Meaningfully** - Only track actions that matter to users
+5. **Test Achievements** - Ensure thresholds are achievable and rewarding
+
+## Testing
+
+```typescript
+import { useGamification } from "@umituz/react-native-settings";
+
+describe("Gamification", () => {
+  it("should track task completion", () => {
+    const { completeTask, totalTasksCompleted } = useGamification();
+    completeTask();
+    expect(totalTasksCompleted).toBe(1);
+  });
+});
+```
+
+## Troubleshooting
+
+### Gamification screen not showing
+- Ensure `gamificationConfig.enabled` is `true`
+- Check that config is passed to `SettingsStackNavigator`
+
+### Achievements not unlocking
+- Verify achievement IDs match between config and localization
+- Check threshold values are correct
+- Ensure `completeTask()` or `addPoints()` is being called
+
+### Localization missing
+- Add all required translation keys
+- Check language files are properly loaded
+
+## Migration Guide
+
+If migrating from standalone gamification package:
+
+```typescript
+// Before
+import { GamificationScreen } from "@umituz/react-native-gamification";
+
+// After
+import { GamificationScreenWrapper } from "@umituz/react-native-settings";
+```
+
+## Related Documentation
+
+- [@umituz/react-native-gamification](../../../react-native-gamification/README.md)
+- [Settings Architecture](../../ARCHITECTURE.md)
+- [Settings Screen Guide](../../SETTINGS_SCREEN_GUIDE.md)
+
+## License
+
+MIT © Ümit UZ

package/src/domains/gamification/components/GamificationScreenWrapper.tsx

@@ -0,0 +1,91 @@
+/**
+ * Gamification Screen Component
+ * Wrapper for @umituz/react-native-gamification screen
+ */
+
+import React, { useMemo } from "react";
+import { GamificationScreen as BaseGamificationScreen } from "@umituz/react-native-gamification";
+import { useGamification } from "@umituz/react-native-gamification";
+import { useLocalization } from "@umituz/react-native-localization";
+import type { GamificationSettingsConfig } from "../types";
+
+export interface GamificationScreenWrapperProps {
+  config: GamificationSettingsConfig;
+}
+
+/**
+ * Gamification Screen for Settings
+ * Displays achievements, levels, streaks, and stats
+ */
+export const GamificationScreenWrapper: React.FC<GamificationScreenWrapperProps> = ({
+  config,
+}) => {
+  const { t } = useLocalization();
+  const gamification = useGamification(config.config);
+
+  const screenProps = useMemo(() => {
+    // Map achievements to screen format
+    const achievements = gamification.achievements.map((achievement) => ({
+      id: achievement.id,
+      title: t(`gamification.achievements.${achievement.id}.title`),
+      description: t(`gamification.achievements.${achievement.id}.description`),
+      icon: "trophy",
+      isUnlocked: achievement.isUnlocked,
+      progress: achievement.progress,
+      threshold: achievement.threshold,
+    }));
+
+    // Map stats
+    const stats = [
+      {
+        icon: "star",
+        value: gamification.points,
+        label: t("gamification.stats.totalPoints"),
+      },
+      {
+        icon: "check-circle",
+        value: gamification.totalTasksCompleted,
+        label: t("gamification.stats.tasksCompleted"),
+      },
+      {
+        icon: "award",
+        value: gamification.achievements.filter((a) => a.isUnlocked).length,
+        label: t("gamification.stats.achievementsUnlocked"),
+      },
+    ];
+
+    // Level props
+    const levelProps = {
+      level: gamification.level.currentLevel,
+      points: gamification.level.currentPoints,
+      levelTitle: t("gamification.level.title", {
+        level: gamification.level.currentLevel,
+      }),
+      pointsToNext: gamification.level.pointsToNext,
+      progress: gamification.level.progress,
+      showPoints: true,
+    };
+
+    // Streak props
+    const streakProps = gamification.streak.current > 0
+      ? {
+          current: gamification.streak.current,
+          longest: gamification.streak.longest,
+          currentLabel: t("gamification.streak.current"),
+          bestLabel: t("gamification.streak.best"),
+          daysLabel: t("gamification.streak.days"),
+        }
+      : undefined;
+
+    return {
+      ...config.screenProps,
+      levelProps,
+      stats,
+      achievements,
+      streakProps,
+      emptyAchievementsText: t("gamification.achievements.empty"),
+    };
+  }, [gamification, config.screenProps, t]);
+
+  return <BaseGamificationScreen {...screenProps} />;
+};

package/src/domains/gamification/components/GamificationSettingsItem.tsx

@@ -0,0 +1,33 @@
+/**
+ * Gamification Settings Item Component
+ * Menu item to navigate to gamification screen
+ */
+
+import React from "react";
+import { SettingsItemCard } from "../../../presentation/components/SettingsItemCard";
+import type { GamificationMenuConfig } from "../types";
+
+export interface GamificationSettingsItemProps {
+  config: GamificationMenuConfig;
+}
+
+/**
+ * Gamification menu item for settings screen
+ */
+export const GamificationSettingsItem: React.FC<GamificationSettingsItemProps> = ({
+  config,
+}) => {
+  if (!config.enabled) {
+    return null;
+  }
+
+  return (
+    <SettingsItemCard
+      title={config.title}
+      description={config.subtitle}
+      icon={config.icon || "trophy"}
+      onPress={config.onPress}
+      showChevron
+    />
+  );
+};

package/src/domains/gamification/examples/gamification.config.example.ts

@@ -0,0 +1,70 @@
+/**
+ * Gamification Configuration Example
+ * 
+ * Copy this file to your app's settings config directory:
+ * src/domains/settings/config/gamification.config.ts
+ */
+
+import type { GamificationSettingsConfig } from "../types";
+
+/**
+ * Creates gamification configuration for settings
+ * 
+ * @param t - Translation function from useLocalization
+ * @returns Gamification settings configuration
+ */
+export const createGamificationConfig = ({ t }): GamificationSettingsConfig => ({
+  enabled: true,
+  
+  // Gamification system configuration
+  config: {
+    storageKey: "app_gamification_data",
+    
+    // Define achievements
+    achievements: [
+      // Count-based achievements
+      { id: "first_task", threshold: 1, type: "count" },
+      { id: "five_tasks", threshold: 5, type: "count" },
+      { id: "ten_tasks", threshold: 10, type: "count" },
+      { id: "fifty_tasks", threshold: 50, type: "count" },
+      { id: "hundred_tasks", threshold: 100, type: "count" },
+      
+      // Streak-based achievements
+      { id: "three_day_streak", threshold: 3, type: "streak" },
+      { id: "week_streak", threshold: 7, type: "streak" },
+      { id: "month_streak", threshold: 30, type: "streak" },
+      
+      // Milestone achievements
+      { id: "first_login", threshold: 1, type: "milestone" },
+      { id: "power_user", threshold: 1, type: "milestone" },
+    ],
+    
+    // Define level progression
+    levels: [
+      { level: 1, minPoints: 0, maxPoints: 50 },
+      { level: 2, minPoints: 50, maxPoints: 150 },
+      { level: 3, minPoints: 150, maxPoints: 300 },
+      { level: 4, minPoints: 300, maxPoints: 500 },
+      { level: 5, minPoints: 500, maxPoints: 800 },
+      { level: 6, minPoints: 800, maxPoints: 1200 },
+      { level: 7, minPoints: 1200, maxPoints: 1700 },
+      { level: 8, minPoints: 1700, maxPoints: 2300 },
+      { level: 9, minPoints: 2300, maxPoints: 3000 },
+      { level: 10, minPoints: 3000, maxPoints: 999999 },
+    ],
+    
+    // Points awarded per action
+    pointsPerAction: 10,
+    
+    // Streak bonus multiplier (1.5 = 50% bonus)
+    streakBonusMultiplier: 1.5,
+  },
+  
+  // Screen display configuration
+  screenProps: {
+    title: t("gamification.title"),
+    statsTitle: t("gamification.stats.title"),
+    achievementsTitle: t("gamification.achievements.title"),
+    streakTitle: t("gamification.streak.title"),
+  },
+});

package/src/domains/gamification/examples/localization.example.json

@@ -0,0 +1,71 @@
+{
+  "settings": {
+    "gamification": {
+      "title": "Achievements",
+      "menuTitle": "Achievements & Progress",
+      "menuSubtitle": "View your achievements and stats"
+    }
+  },
+  "gamification": {
+    "title": "Your Progress",
+    "level": {
+      "title": "Level {{level}}"
+    },
+    "stats": {
+      "title": "Statistics",
+      "totalPoints": "Total Points",
+      "tasksCompleted": "Tasks Completed",
+      "achievementsUnlocked": "Achievements Unlocked"
+    },
+    "achievements": {
+      "title": "Achievements",
+      "empty": "No achievements yet. Keep going!",
+      "first_task": {
+        "title": "First Steps",
+        "description": "Complete your first task"
+      },
+      "five_tasks": {
+        "title": "Getting Started",
+        "description": "Complete 5 tasks"
+      },
+      "ten_tasks": {
+        "title": "On a Roll",
+        "description": "Complete 10 tasks"
+      },
+      "fifty_tasks": {
+        "title": "Dedicated",
+        "description": "Complete 50 tasks"
+      },
+      "hundred_tasks": {
+        "title": "Century Club",
+        "description": "Complete 100 tasks"
+      },
+      "three_day_streak": {
+        "title": "Consistent",
+        "description": "Maintain a 3-day streak"
+      },
+      "week_streak": {
+        "title": "Week Warrior",
+        "description": "Maintain a 7-day streak"
+      },
+      "month_streak": {
+        "title": "Monthly Master",
+        "description": "Maintain a 30-day streak"
+      },
+      "first_login": {
+        "title": "Welcome!",
+        "description": "Join the community"
+      },
+      "power_user": {
+        "title": "Power User",
+        "description": "Unlock all features"
+      }
+    },
+    "streak": {
+      "title": "Daily Streak",
+      "current": "Current Streak",
+      "best": "Best Streak",
+      "days": "days"
+    }
+  }
+}

package/src/domains/gamification/index.ts

@@ -0,0 +1,38 @@
+/**
+ * Gamification Domain - Public API
+ */
+
+// Types
+export type {
+  GamificationSettingsConfig,
+  GamificationMenuConfig,
+} from "./types";
+
+// Components
+export { GamificationScreenWrapper } from "./components/GamificationScreenWrapper";
+export type { GamificationScreenWrapperProps } from "./components/GamificationScreenWrapper";
+
+export { GamificationSettingsItem } from "./components/GamificationSettingsItem";
+export type { GamificationSettingsItemProps } from "./components/GamificationSettingsItem";
+
+// Re-export from gamification package for convenience
+export {
+  useGamification,
+  useGamificationStore,
+  LevelProgress,
+  PointsBadge,
+  AchievementCard,
+  AchievementToast,
+  StreakDisplay,
+  StatsCard,
+  AchievementItem,
+} from "@umituz/react-native-gamification";
+
+export type {
+  GamificationConfig,
+  GamificationState,
+  Achievement,
+  LevelState,
+  StreakState,
+  UseGamificationReturn,
+} from "@umituz/react-native-gamification";

package/src/domains/gamification/types/index.ts

@@ -0,0 +1,31 @@
+/**
+ * Gamification Domain - Types
+ * Settings package integration for gamification
+ */
+
+import type {
+  GamificationConfig,
+  GamificationScreenProps,
+} from "@umituz/react-native-gamification";
+
+/**
+ * Gamification settings configuration
+ * Passed from app to settings package
+ */
+export interface GamificationSettingsConfig {
+  enabled: boolean;
+  config: GamificationConfig;
+  screenProps: Omit<GamificationScreenProps, "levelProps" | "stats" | "achievements">;
+  onNavigate?: () => void;
+}
+
+/**
+ * Gamification menu item configuration
+ */
+export interface GamificationMenuConfig {
+  enabled: boolean;
+  title: string;
+  subtitle?: string;
+  icon?: string;
+  onPress?: () => void;
+}

package/src/index.ts

@@ -120,14 +120,24 @@ export * from "./domains/cloud-sync";
 // Dev Domain - Development-only settings (DEV mode)
 export * from "./domains/dev";
 
+// Gamification Domain - Achievements, levels, streaks
+export * from "./domains/gamification";
+
+
 // =============================================================================
-// PRESENTATION LAYER - Re-exports from Dependencies
+// PRESENTATION LAYER - Config Creator Utilities
 // =============================================================================
 
-// @ts-ignore - Re-exporting from peer dependency
-export { OnboardingResetSetting } from '@umituz/react-native-onboarding';
-// @ts-ignore - Re-exporting from peer dependency  
-export type { OnboardingResetSettingProps } from '@umituz/react-native-onboarding';
-
-// @ts-ignore - Re-exporting from peer dependency
-// @ts-ignore - Re-exporting from peer dependency
+export {
+  createAppearanceConfig,
+  createLanguageConfig,
+  createNotificationsConfig,
+  createAboutConfig,
+  createLegalConfig,
+  createFeedbackConfig,
+  createRatingConfig,
+  createFAQConfig,
+  createSubscriptionConfig,
+  type TranslationFunction,
+  type FeedbackFormData,
+} from './presentation/utils';

package/src/presentation/navigation/SettingsStackNavigator.tsx

@@ -29,8 +29,10 @@ import {
   createNotificationsScreenOptions,
   createFAQScreenOptions,
   createLanguageSelectionScreenOptions,
+  createGamificationScreenOptions,
 } from "./utils";
 import type { SettingsStackParamList, SettingsStackNavigatorProps } from "./types";
+import { GamificationScreenWrapper } from "../../domains/gamification";
 
 const Stack = createStackNavigator<SettingsStackParamList>();
 
@@ -45,6 +47,7 @@ export const SettingsStackNavigator: React.FC<SettingsStackNavigatorProps> = ({
   devSettings,
   customSections = [],
   showHeader = true,
+  gamificationConfig,
 }) => {
   const tokens = useAppDesignTokens();
   const { t } = useLocalization();
@@ -143,6 +146,15 @@ export const SettingsStackNavigator: React.FC<SettingsStackNavigatorProps> = ({
         ) : null
       )}
 
+      {gamificationConfig?.enabled && (
+        <Stack.Screen
+          name="Gamification"
+          options={createGamificationScreenOptions(t)}
+        >
+          {() => <GamificationScreenWrapper config={gamificationConfig} />}
+        </Stack.Screen>
+      )}
+
       <Stack.Screen
         name="LanguageSelection"
         options={createLanguageSelectionScreenOptions(t)}

package/src/presentation/navigation/types.ts

@@ -42,6 +42,7 @@ export type SettingsStackParamList = {
   Notifications: undefined;
   FAQ: undefined;
   LanguageSelection: undefined;
+  Gamification: undefined;
 };
 
 /**
@@ -89,4 +90,5 @@ export interface SettingsStackNavigatorProps {
   devSettings?: DevSettingsProps;
   customSections?: CustomSettingsSection[];
   showHeader?: boolean;
+  gamificationConfig?: import("../../domains/gamification").GamificationSettingsConfig;
 }

package/src/presentation/navigation/utils/navigationScreenOptions.ts

@@ -54,3 +54,10 @@ export const createLanguageSelectionScreenOptions = (t: any) => ({
   headerTitle: t("settings.language.title"),
   headerTitleAlign: "center" as const,
 });
+
+export const createGamificationScreenOptions = (t: any) => ({
+  headerShown: true,
+  headerTitle: t("settings.gamification.title"),
+  headerTitleAlign: "center" as const,
+});
+

package/src/presentation/screens/SettingsScreen.tsx

@@ -50,6 +50,7 @@ export interface SettingsScreenProps {
     notificationServiceAvailable?: boolean;
   };
   /** Dev settings (only shown in __DEV__ mode) */
+  devSettings?: DevSettingsProps;
   /** Show header (default: true) */
   showHeader?: boolean;
 }

package/src/presentation/screens/types/UserFeatureConfig.ts

@@ -12,6 +12,8 @@ import type { FeedbackType } from "../../../domains/feedback/domain/entities/Fee
 export interface UserProfileConfig {
   /** Show user profile header */
   enabled?: boolean;
+  /** Custom section title for grouping */
+  sectionTitle?: string;
   /** Custom display name for anonymous users */
   anonymousDisplayName?: string;
   /** Custom avatar service URL */

package/src/presentation/utils/configCreators.ts

@@ -0,0 +1,147 @@
+/**
+ * Settings Config Creators
+ * Utility functions to create standard settings configurations
+ * Used across 100+ apps - keep generic and flexible
+ */
+
+import type {
+  AppearanceConfig,
+  LanguageConfig,
+  NotificationsConfig,
+  AboutConfig,
+  LegalConfig,
+  FeedbackConfig,
+  UserProfileConfig,
+  RatingConfig,
+  FAQConfig,
+  SubscriptionConfig,
+} from "../screens/types";
+
+/**
+ * Translation function type
+ */
+export type TranslationFunction = (key: string) => string;
+
+/**
+ * Create appearance configuration
+ */
+export const createAppearanceConfig = (t: TranslationFunction): AppearanceConfig => ({
+  enabled: true,
+  title: t("settings.appearance.title"),
+  description: t("settings.appearance.description"),
+  icon: "color-palette-outline",
+});
+
+/**
+ * Create language configuration
+ */
+export const createLanguageConfig = (t: TranslationFunction): LanguageConfig => ({
+  enabled: true,
+  title: t("settings.language.title"),
+  description: t("settings.language.description"),
+  icon: "globe-outline",
+});
+
+/**
+ * Create notifications configuration
+ */
+export const createNotificationsConfig = (t: TranslationFunction): NotificationsConfig => ({
+  enabled: true,
+  showToggle: false,
+  route: "Notifications",
+  title: t("settings.notifications.title"),
+  description: t("settings.notifications.description"),
+  icon: "notifications-outline",
+});
+
+/**
+ * Create about configuration
+ */
+export const createAboutConfig = (t: TranslationFunction): AboutConfig => ({
+  enabled: true,
+  title: t("settings.about.title"),
+  description: t("settings.about.description"),
+  icon: "information-circle-outline",
+});
+
+/**
+ * Create legal configuration
+ */
+export const createLegalConfig = (t: TranslationFunction): LegalConfig => ({
+  enabled: true,
+  title: t("settings.legal.title"),
+  description: t("settings.legal.description"),
+  icon: "document-text-outline",
+});
+
+/**
+ * Feedback form data interface
+ */
+export interface FeedbackFormData {
+  type: string;
+  rating: number;
+  description: string;
+  title: string;
+}
+
+/**
+ * Create feedback configuration
+ */
+export const createFeedbackConfig = (
+  t: TranslationFunction,
+  onSubmit: (data: FeedbackFormData) => Promise<void>,
+): FeedbackConfig => ({
+  enabled: true,
+  title: t("settings.feedback.title"),
+  description: t("settings.feedback.description"),
+  icon: "chatbubble-outline",
+  sectionTitle: t("settings.sections.support"),
+  onSubmit,
+});
+
+/**
+ * Create rating configuration
+ */
+export const createRatingConfig = (
+  t: TranslationFunction,
+  onRate: () => void,
+  storeUrl?: string,
+): RatingConfig => ({
+  enabled: true,
+  onRate,
+  storeUrl,
+});
+
+/**
+ * Create FAQ configuration
+ */
+export const createFAQConfig = (
+  t: TranslationFunction,
+  onPress: () => void,
+): FAQConfig => ({
+  enabled: true,
+  title: t("settings.faqs.title"),
+  description: t("settings.faqs.description"),
+  icon: "help-circle-outline",
+  sectionTitle: t("settings.sections.support").toUpperCase(),
+  onPress,
+});
+
+/**
+ * Create subscription configuration
+ */
+export const createSubscriptionConfig = (
+  t: TranslationFunction,
+  isPremium: boolean,
+  onPress: () => void,
+): SubscriptionConfig => ({
+  enabled: true,
+  title: t("settings.subscription.title"),
+  description: isPremium
+    ? t("subscription.premiumDetails.statusActive")
+    : t("settings.subscription.description"),
+  icon: "diamond",
+  sectionTitle: t("settings.sections.subscription").toUpperCase(),
+  onPress,
+  isPremium,
+});

package/src/presentation/utils/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Settings Utilities
+ */
+
+export * from "./configCreators";