@umituz/react-native-gamification 1.2.1 → 1.4.0

package/src/components/GamificationScreen.tsx

@@ -0,0 +1,236 @@
+/**
+ * GamificationScreen Component
+ * Full gamification screen - all text via props
+ * Generic for 100+ apps - NO hardcoded strings
+ */
+
+import React from "react";
+import {
+  View,
+  Text,
+  ScrollView,
+  StyleSheet,
+  type ViewStyle,
+  type TextStyle,
+} from "react-native";
+import { LevelProgress, type LevelProgressProps } from "./LevelProgress";
+import { StatsCard, type StatsCardProps } from "./StatsCard";
+import { AchievementItem, type AchievementItemProps } from "./AchievementItem";
+import { StreakDisplay, type StreakDisplayProps } from "./StreakDisplay";
+
+export interface GamificationScreenProps {
+  // Section titles (all via props)
+  title: string;
+  statsTitle: string;
+  achievementsTitle: string;
+  streakTitle: string;
+
+  // Level data
+  levelProps: Omit<LevelProgressProps, "primaryColor" | "backgroundColor" | "textColor" | "subtextColor">;
+
+  // Stats data
+  stats: Array<Omit<StatsCardProps, "accentColor" | "backgroundColor" | "textColor" | "subtextColor">>;
+
+  // Achievements data
+  achievements: Array<
+    Omit<AchievementItemProps, "accentColor" | "backgroundColor" | "textColor" | "subtextColor" | "lockedOpacity">
+  >;
+
+  // Streak data (optional)
+  streakProps?: Omit<StreakDisplayProps, "primaryColor" | "backgroundColor" | "textColor" | "subtextColor">;
+
+  // Empty state
+  emptyAchievementsText?: string;
+
+  // Customization
+  containerStyle?: ViewStyle;
+  headerStyle?: ViewStyle;
+  titleStyle?: TextStyle;
+  sectionTitleStyle?: TextStyle;
+
+  // Colors (applied to all child components)
+  accentColor?: string;
+  backgroundColor?: string;
+  cardBackgroundColor?: string;
+  textColor?: string;
+  subtextColor?: string;
+
+  // Header component (optional - for back button etc)
+  headerComponent?: React.ReactNode;
+}
+
+export const GamificationScreen: React.FC<GamificationScreenProps> = ({
+  title,
+  statsTitle,
+  achievementsTitle,
+  streakTitle,
+  levelProps,
+  stats,
+  achievements,
+  streakProps,
+  emptyAchievementsText,
+  containerStyle,
+  headerStyle,
+  titleStyle,
+  sectionTitleStyle,
+  accentColor = "#FFD700",
+  backgroundColor = "#0A0A0A",
+  cardBackgroundColor = "#1A1A1A",
+  textColor = "#FFFFFF",
+  subtextColor = "#888888",
+  headerComponent,
+}) => {
+  const unlockedAchievements = achievements.filter((a) => a.isUnlocked);
+  const lockedAchievements = achievements.filter((a) => !a.isUnlocked);
+
+  return (
+    <View style={[styles.container, { backgroundColor }, containerStyle]}>
+      {headerComponent}
+
+      <ScrollView
+        style={styles.scrollView}
+        contentContainerStyle={styles.scrollContent}
+        showsVerticalScrollIndicator={false}
+      >
+        {/* Header */}
+        <View style={[styles.header, headerStyle]}>
+          <Text style={[styles.title, { color: textColor }, titleStyle]}>
+            {title}
+          </Text>
+        </View>
+
+        {/* Level Progress */}
+        <View style={styles.section}>
+          <LevelProgress
+            {...levelProps}
+            primaryColor={accentColor}
+            backgroundColor={cardBackgroundColor}
+            textColor={textColor}
+            subtextColor={subtextColor}
+          />
+        </View>
+
+        {/* Streak (if provided) */}
+        {streakProps && (
+          <View style={styles.section}>
+            <Text
+              style={[styles.sectionTitle, { color: textColor }, sectionTitleStyle]}
+            >
+              {streakTitle}
+            </Text>
+            <StreakDisplay
+              {...streakProps}
+              primaryColor={accentColor}
+              backgroundColor={cardBackgroundColor}
+              textColor={textColor}
+              subtextColor={subtextColor}
+            />
+          </View>
+        )}
+
+        {/* Stats Grid */}
+        {stats.length > 0 && (
+          <View style={styles.section}>
+            <Text
+              style={[styles.sectionTitle, { color: textColor }, sectionTitleStyle]}
+            >
+              {statsTitle}
+            </Text>
+            <View style={styles.statsGrid}>
+              {stats.map((stat, index) => (
+                <StatsCard
+                  key={index}
+                  {...stat}
+                  accentColor={accentColor}
+                  backgroundColor={cardBackgroundColor}
+                  textColor={textColor}
+                  subtextColor={subtextColor}
+                />
+              ))}
+            </View>
+          </View>
+        )}
+
+        {/* Achievements */}
+        <View style={styles.section}>
+          <Text
+            style={[styles.sectionTitle, { color: textColor }, sectionTitleStyle]}
+          >
+            {achievementsTitle}
+          </Text>
+
+          {achievements.length === 0 && emptyAchievementsText ? (
+            <Text style={[styles.emptyText, { color: subtextColor }]}>
+              {emptyAchievementsText}
+            </Text>
+          ) : (
+            <>
+              {/* Unlocked achievements first */}
+              {unlockedAchievements.map((achievement, index) => (
+                <AchievementItem
+                  key={`unlocked-${index}`}
+                  {...achievement}
+                  accentColor={accentColor}
+                  backgroundColor={cardBackgroundColor}
+                  textColor={textColor}
+                  subtextColor={subtextColor}
+                />
+              ))}
+
+              {/* Locked achievements */}
+              {lockedAchievements.map((achievement, index) => (
+                <AchievementItem
+                  key={`locked-${index}`}
+                  {...achievement}
+                  accentColor={accentColor}
+                  backgroundColor={cardBackgroundColor}
+                  textColor={textColor}
+                  subtextColor={subtextColor}
+                  lockedOpacity={0.6}
+                />
+              ))}
+            </>
+          )}
+        </View>
+      </ScrollView>
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+  },
+  scrollView: {
+    flex: 1,
+  },
+  scrollContent: {
+    padding: 16,
+    paddingBottom: 32,
+  },
+  header: {
+    marginBottom: 20,
+  },
+  title: {
+    fontSize: 28,
+    fontWeight: "bold",
+  },
+  section: {
+    marginBottom: 24,
+  },
+  sectionTitle: {
+    fontSize: 18,
+    fontWeight: "600",
+    marginBottom: 12,
+  },
+  statsGrid: {
+    flexDirection: "row",
+    flexWrap: "wrap",
+    gap: 12,
+  },
+  emptyText: {
+    fontSize: 14,
+    textAlign: "center",
+    paddingVertical: 20,
+  },
+});

package/src/components/LevelProgress.tsx

@@ -0,0 +1,129 @@
+/**
+ * LevelProgress Component
+ * Displays level and progress - all text via props
+ */
+
+import React from "react";
+import { View, Text, StyleSheet, type ViewStyle, type TextStyle } from "react-native";
+
+export interface LevelProgressProps {
+  level: number;
+  points: number;
+  levelTitle: string;
+  pointsToNext: number;
+  progress: number;
+  showPoints?: boolean;
+  // Customization
+  containerStyle?: ViewStyle;
+  titleStyle?: TextStyle;
+  subtitleStyle?: TextStyle;
+  progressBarStyle?: ViewStyle;
+  progressFillStyle?: ViewStyle;
+  badgeStyle?: ViewStyle;
+  badgeTextStyle?: TextStyle;
+  // Colors (design system integration)
+  primaryColor?: string;
+  secondaryColor?: string;
+  backgroundColor?: string;
+  textColor?: string;
+  subtextColor?: string;
+}
+
+export const LevelProgress: React.FC<LevelProgressProps> = ({
+  level,
+  points,
+  levelTitle,
+  pointsToNext,
+  progress,
+  showPoints = true,
+  containerStyle,
+  titleStyle,
+  subtitleStyle,
+  progressBarStyle,
+  progressFillStyle,
+  badgeStyle,
+  badgeTextStyle,
+  primaryColor = "#FFD700",
+  secondaryColor = "#2A2A2A",
+  backgroundColor = "#1A1A1A",
+  textColor = "#FFFFFF",
+  subtextColor = "#888888",
+}) => {
+  return (
+    <View style={[styles.container, { backgroundColor }, containerStyle]}>
+      <View style={styles.header}>
+        <View style={styles.titleSection}>
+          <Text style={[styles.levelTitle, { color: textColor }, titleStyle]}>
+            {levelTitle}
+          </Text>
+          {showPoints && (
+            <Text style={[styles.subtitle, { color: subtextColor }, subtitleStyle]}>
+              {points} / {points + pointsToNext}
+            </Text>
+          )}
+        </View>
+
+        <View style={[styles.badge, { backgroundColor: `${primaryColor}20`, borderColor: `${primaryColor}40` }, badgeStyle]}>
+          <Text style={[styles.badgeText, { color: primaryColor }, badgeTextStyle]}>
+            {level}
+          </Text>
+        </View>
+      </View>
+
+      <View style={[styles.progressBar, { backgroundColor: secondaryColor }, progressBarStyle]}>
+        <View
+          style={[
+            styles.progressFill,
+            { width: `${Math.min(100, progress)}%`, backgroundColor: primaryColor },
+            progressFillStyle,
+          ]}
+        />
+      </View>
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    borderRadius: 16,
+    padding: 16,
+  },
+  header: {
+    flexDirection: "row",
+    justifyContent: "space-between",
+    alignItems: "center",
+    marginBottom: 12,
+  },
+  titleSection: {
+    flex: 1,
+  },
+  levelTitle: {
+    fontSize: 18,
+    fontWeight: "700",
+  },
+  subtitle: {
+    fontSize: 14,
+    marginTop: 2,
+  },
+  badge: {
+    width: 48,
+    height: 48,
+    borderRadius: 24,
+    justifyContent: "center",
+    alignItems: "center",
+    borderWidth: 2,
+  },
+  badgeText: {
+    fontSize: 18,
+    fontWeight: "bold",
+  },
+  progressBar: {
+    height: 8,
+    borderRadius: 4,
+    overflow: "hidden",
+  },
+  progressFill: {
+    height: "100%",
+    borderRadius: 4,
+  },
+});

package/src/components/PointsBadge.tsx

@@ -0,0 +1,60 @@
+/**
+ * PointsBadge Component
+ * Displays points with optional icon - all text via props
+ */
+
+import React from "react";
+import { View, Text, StyleSheet, type ViewStyle, type TextStyle } from "react-native";
+
+export interface PointsBadgeProps {
+  points: number;
+  icon?: React.ReactNode;
+  // Customization
+  containerStyle?: ViewStyle;
+  textStyle?: TextStyle;
+  // Colors
+  backgroundColor?: string;
+  textColor?: string;
+  borderColor?: string;
+}
+
+export const PointsBadge: React.FC<PointsBadgeProps> = ({
+  points,
+  icon,
+  containerStyle,
+  textStyle,
+  backgroundColor = "#FFD70020",
+  textColor = "#FFD700",
+  borderColor = "#FFD70040",
+}) => {
+  return (
+    <View
+      style={[
+        styles.container,
+        { backgroundColor, borderColor },
+        containerStyle,
+      ]}
+    >
+      {icon}
+      <Text style={[styles.text, { color: textColor }, textStyle]}>
+        {points}
+      </Text>
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 6,
+    paddingHorizontal: 12,
+    paddingVertical: 6,
+    borderRadius: 20,
+    borderWidth: 1,
+  },
+  text: {
+    fontSize: 16,
+    fontWeight: "bold",
+  },
+});

package/src/components/StatsCard.tsx

@@ -0,0 +1,89 @@
+/**
+ * StatsCard Component
+ * Displays a stat with icon - all text via props
+ */
+
+import React from "react";
+import { View, Text, StyleSheet, type ViewStyle, type TextStyle } from "react-native";
+
+export interface StatsCardProps {
+  value: number;
+  label: string;
+  icon: React.ReactNode;
+  suffix?: string;
+  // Customization
+  containerStyle?: ViewStyle;
+  valueStyle?: TextStyle;
+  labelStyle?: TextStyle;
+  // Colors
+  accentColor?: string;
+  backgroundColor?: string;
+  textColor?: string;
+  subtextColor?: string;
+}
+
+export const StatsCard: React.FC<StatsCardProps> = ({
+  value,
+  label,
+  icon,
+  suffix,
+  containerStyle,
+  valueStyle,
+  labelStyle,
+  accentColor = "#FFD700",
+  backgroundColor = "#1A1A1A",
+  textColor = "#FFFFFF",
+  subtextColor = "#888888",
+}) => {
+  return (
+    <View style={[styles.container, { backgroundColor }, containerStyle]}>
+      <View style={[styles.iconContainer, { backgroundColor: `${accentColor}15` }]}>
+        {icon}
+      </View>
+      <View style={styles.valueRow}>
+        <Text style={[styles.value, { color: textColor }, valueStyle]}>
+          {value}
+        </Text>
+        {suffix && (
+          <Text style={[styles.suffix, { color: subtextColor }]}>{suffix}</Text>
+        )}
+      </View>
+      <Text style={[styles.label, { color: subtextColor }, labelStyle]}>
+        {label}
+      </Text>
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    minWidth: "45%",
+    borderRadius: 12,
+    padding: 12,
+  },
+  iconContainer: {
+    width: 36,
+    height: 36,
+    borderRadius: 18,
+    alignItems: "center",
+    justifyContent: "center",
+    marginBottom: 8,
+  },
+  valueRow: {
+    flexDirection: "row",
+    alignItems: "baseline",
+    gap: 4,
+  },
+  value: {
+    fontSize: 24,
+    fontWeight: "bold",
+  },
+  suffix: {
+    fontSize: 12,
+  },
+  label: {
+    fontSize: 12,
+    marginTop: 2,
+  },
+});

package/src/components/StreakDisplay.tsx

@@ -0,0 +1,119 @@
+/**
+ * StreakDisplay Component
+ * Displays streak information - all text via props
+ */
+
+import React from "react";
+import { View, Text, StyleSheet, type ViewStyle, type TextStyle } from "react-native";
+
+export interface StreakDisplayProps {
+  current: number;
+  longest: number;
+  currentLabel: string; // e.g., "Current Streak"
+  bestLabel: string; // e.g., "Best"
+  daysLabel: string; // e.g., "days"
+  icon?: React.ReactNode;
+  // Customization
+  containerStyle?: ViewStyle;
+  numberStyle?: TextStyle;
+  labelStyle?: TextStyle;
+  // Colors
+  primaryColor?: string;
+  backgroundColor?: string;
+  textColor?: string;
+  subtextColor?: string;
+}
+
+export const StreakDisplay: React.FC<StreakDisplayProps> = ({
+  current,
+  longest,
+  currentLabel,
+  bestLabel,
+  daysLabel,
+  icon,
+  containerStyle,
+  numberStyle,
+  labelStyle,
+  primaryColor = "#FF6B35",
+  backgroundColor = "#1A1A1A",
+  textColor = "#FFFFFF",
+  subtextColor = "#888888",
+}) => {
+  return (
+    <View style={[styles.container, { backgroundColor }, containerStyle]}>
+      <View style={styles.mainStreak}>
+        {icon && <View style={styles.iconContainer}>{icon}</View>}
+        <View style={styles.streakInfo}>
+          <Text style={[styles.number, { color: primaryColor }, numberStyle]}>
+            {current}
+          </Text>
+          <Text style={[styles.label, { color: subtextColor }, labelStyle]}>
+            {daysLabel}
+          </Text>
+        </View>
+        <Text style={[styles.currentLabel, { color: textColor }]}>
+          {currentLabel}
+        </Text>
+      </View>
+
+      <View style={[styles.bestStreak, { backgroundColor: `${primaryColor}20` }]}>
+        <Text style={[styles.bestLabel, { color: subtextColor }]}>
+          {bestLabel}
+        </Text>
+        <Text style={[styles.bestNumber, { color: primaryColor }]}>
+          {longest}
+        </Text>
+      </View>
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    borderRadius: 16,
+    padding: 16,
+    flexDirection: "row",
+    alignItems: "center",
+    justifyContent: "space-between",
+  },
+  mainStreak: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 12,
+  },
+  iconContainer: {
+    width: 40,
+    height: 40,
+    justifyContent: "center",
+    alignItems: "center",
+  },
+  streakInfo: {
+    alignItems: "center",
+  },
+  number: {
+    fontSize: 32,
+    fontWeight: "bold",
+  },
+  label: {
+    fontSize: 12,
+    textTransform: "uppercase",
+  },
+  currentLabel: {
+    fontSize: 14,
+    fontWeight: "500",
+  },
+  bestStreak: {
+    paddingHorizontal: 12,
+    paddingVertical: 8,
+    borderRadius: 12,
+    alignItems: "center",
+  },
+  bestLabel: {
+    fontSize: 11,
+    textTransform: "uppercase",
+  },
+  bestNumber: {
+    fontSize: 18,
+    fontWeight: "bold",
+  },
+});

package/src/components/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Gamification Components
+ * All text via props - NO hardcoded strings
+ */
+
+export { LevelProgress, type LevelProgressProps } from "./LevelProgress";
+export { PointsBadge, type PointsBadgeProps } from "./PointsBadge";
+export { AchievementCard, type AchievementCardProps } from "./AchievementCard";
+export { AchievementToast, type AchievementToastProps } from "./AchievementToast";
+export { StreakDisplay, type StreakDisplayProps } from "./StreakDisplay";
+export { StatsCard, type StatsCardProps } from "./StatsCard";
+export { AchievementItem, type AchievementItemProps } from "./AchievementItem";
+export { GamificationScreen, type GamificationScreenProps } from "./GamificationScreen";