@umituz/react-native-gamification 1.2.1 → 1.4.0

package/LICENSE

@@ -22,3 +22,8 @@ SOFTWARE.
 
 
 
+
+
+
+
+

package/README.md

@@ -276,3 +276,8 @@ MIT
 
 
 
+
+
+
+
+

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "@umituz/react-native-gamification",
-  "version": "1.2.1",
-  "description": "Comprehensive gamification system for React Native apps with achievements, points, levels, streaks, leaderboards, rewards, and progress tracking",
+  "version": "1.4.0",
+  "description": "Generic gamification system for React Native apps - achievements, points, levels, streaks with customizable UI components",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "lint": "tsc --noEmit",
-    "version:minor": "npm version minor -m 'chore: release v%s'",
-    "version:major": "npm version major -m 'chore: release v%s'"
+    "lint": "tsc --noEmit"
   },
   "keywords": [
     "react-native",
@@ -17,10 +15,8 @@
     "points",
     "levels",
     "streaks",
-    "leaderboards",
-    "rewards",
     "progress",
-    "gameification"
+    "rewards"
   ],
   "author": "Ümit UZ <umit@umituz.com>",
   "license": "MIT",
@@ -29,19 +25,19 @@
     "url": "https://github.com/umituz/react-native-gamification"
   },
   "peerDependencies": {
+    "@react-native-async-storage/async-storage": ">=1.21.0",
     "react": ">=18.2.0",
     "react-native": ">=0.74.0",
-    "@umituz/react-native-storage": "latest",
     "zustand": ">=4.0.0"
   },
   "devDependencies": {
+    "@react-native-async-storage/async-storage": "^1.23.1",
+    "@types/node": "^25.0.2",
     "@types/react": "^18.2.45",
     "@types/react-native": "^0.73.0",
     "react": "^18.2.0",
     "react-native": "^0.74.0",
-    "typescript": "^5.3.3"
-  },
-  "dependencies": {
+    "typescript": "^5.3.3",
     "zustand": "^4.5.0"
   },
   "publishConfig": {
@@ -53,5 +49,3 @@
     "LICENSE"
   ]
 }
-
-

package/src/components/AchievementCard.tsx

@@ -0,0 +1,142 @@
+/**
+ * AchievementCard Component
+ * Displays achievement - all text via props
+ */
+
+import React from "react";
+import { View, Text, StyleSheet, type ViewStyle, type TextStyle } from "react-native";
+
+export interface AchievementCardProps {
+  title: string;
+  description: string;
+  icon: React.ReactNode;
+  isUnlocked: boolean;
+  progress: number;
+  // Customization
+  containerStyle?: ViewStyle;
+  titleStyle?: TextStyle;
+  descriptionStyle?: TextStyle;
+  progressBarStyle?: ViewStyle;
+  // Colors
+  unlockedColor?: string;
+  lockedColor?: string;
+  backgroundColor?: string;
+  textColor?: string;
+  subtextColor?: string;
+}
+
+export const AchievementCard: React.FC<AchievementCardProps> = ({
+  title,
+  description,
+  icon,
+  isUnlocked,
+  progress,
+  containerStyle,
+  titleStyle,
+  descriptionStyle,
+  progressBarStyle,
+  unlockedColor = "#4CAF50",
+  lockedColor = "#666666",
+  backgroundColor = "#1A1A1A",
+  textColor = "#FFFFFF",
+  subtextColor = "#888888",
+}) => {
+  const accentColor = isUnlocked ? unlockedColor : lockedColor;
+
+  return (
+    <View
+      style={[
+        styles.container,
+        { backgroundColor, borderColor: `${accentColor}40` },
+        containerStyle,
+      ]}
+    >
+      <View style={[styles.iconContainer, { backgroundColor: `${accentColor}20` }]}>
+        {icon}
+      </View>
+
+      <View style={styles.content}>
+        <Text
+          style={[
+            styles.title,
+            { color: isUnlocked ? textColor : subtextColor },
+            titleStyle,
+          ]}
+        >
+          {title}
+        </Text>
+        <Text style={[styles.description, { color: subtextColor }, descriptionStyle]}>
+          {description}
+        </Text>
+
+        {!isUnlocked && (
+          <View style={[styles.progressBar, { backgroundColor: `${lockedColor}40` }, progressBarStyle]}>
+            <View
+              style={[
+                styles.progressFill,
+                { width: `${progress}%`, backgroundColor: accentColor },
+              ]}
+            />
+          </View>
+        )}
+      </View>
+
+      {isUnlocked && (
+        <View style={[styles.checkmark, { backgroundColor: unlockedColor }]}>
+          <Text style={styles.checkmarkText}>✓</Text>
+        </View>
+      )}
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    flexDirection: "row",
+    alignItems: "center",
+    padding: 12,
+    borderRadius: 12,
+    borderWidth: 1,
+    gap: 12,
+  },
+  iconContainer: {
+    width: 48,
+    height: 48,
+    borderRadius: 24,
+    justifyContent: "center",
+    alignItems: "center",
+  },
+  content: {
+    flex: 1,
+  },
+  title: {
+    fontSize: 16,
+    fontWeight: "600",
+  },
+  description: {
+    fontSize: 13,
+    marginTop: 2,
+  },
+  progressBar: {
+    height: 4,
+    borderRadius: 2,
+    marginTop: 8,
+    overflow: "hidden",
+  },
+  progressFill: {
+    height: "100%",
+    borderRadius: 2,
+  },
+  checkmark: {
+    width: 24,
+    height: 24,
+    borderRadius: 12,
+    justifyContent: "center",
+    alignItems: "center",
+  },
+  checkmarkText: {
+    color: "#FFFFFF",
+    fontSize: 14,
+    fontWeight: "bold",
+  },
+});

package/src/components/AchievementItem.tsx

@@ -0,0 +1,182 @@
+/**
+ * AchievementItem Component
+ * List item for achievements - all text via props
+ */
+
+import React from "react";
+import {
+  View,
+  Text,
+  StyleSheet,
+  type ViewStyle,
+  type TextStyle,
+} from "react-native";
+
+export interface AchievementItemProps {
+  title: string;
+  description: string;
+  icon: React.ReactNode;
+  isUnlocked: boolean;
+  progress: number;
+  threshold: number;
+  progressLabel?: string;
+  // Customization
+  containerStyle?: ViewStyle;
+  titleStyle?: TextStyle;
+  descriptionStyle?: TextStyle;
+  // Colors
+  accentColor?: string;
+  backgroundColor?: string;
+  textColor?: string;
+  subtextColor?: string;
+  lockedOpacity?: number;
+}
+
+export const AchievementItem: React.FC<AchievementItemProps> = ({
+  title,
+  description,
+  icon,
+  isUnlocked,
+  progress,
+  threshold,
+  progressLabel,
+  containerStyle,
+  titleStyle,
+  descriptionStyle,
+  accentColor = "#FFD700",
+  backgroundColor = "#1A1A1A",
+  textColor = "#FFFFFF",
+  subtextColor = "#888888",
+  lockedOpacity = 0.5,
+}) => {
+  const progressPercent = Math.min((progress / threshold) * 100, 100);
+
+  return (
+    <View
+      style={[
+        styles.container,
+        { backgroundColor, opacity: isUnlocked ? 1 : lockedOpacity },
+        containerStyle,
+      ]}
+    >
+      <View
+        style={[styles.iconContainer, { backgroundColor: `${accentColor}20` }]}
+      >
+        {icon}
+      </View>
+
+      <View style={styles.content}>
+        <View style={styles.header}>
+          <Text style={[styles.title, { color: textColor }, titleStyle]}>
+            {title}
+          </Text>
+          {isUnlocked && (
+            <View style={[styles.checkmark, { backgroundColor: accentColor }]}>
+              <Text style={styles.checkmarkText}>✓</Text>
+            </View>
+          )}
+        </View>
+
+        <Text
+          style={[styles.description, { color: subtextColor }, descriptionStyle]}
+          numberOfLines={2}
+        >
+          {description}
+        </Text>
+
+        {!isUnlocked && (
+          <View style={styles.progressContainer}>
+            <View
+              style={[styles.progressBar, { backgroundColor: `${accentColor}30` }]}
+            >
+              <View
+                style={[
+                  styles.progressFill,
+                  {
+                    backgroundColor: accentColor,
+                    width: `${progressPercent}%`,
+                  },
+                ]}
+              />
+            </View>
+            {progressLabel && (
+              <Text style={[styles.progressText, { color: subtextColor }]}>
+                {progressLabel}
+              </Text>
+            )}
+          </View>
+        )}
+      </View>
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    flexDirection: "row",
+    alignItems: "center",
+    padding: 12,
+    borderRadius: 12,
+    marginBottom: 8,
+  },
+  iconContainer: {
+    width: 48,
+    height: 48,
+    borderRadius: 24,
+    alignItems: "center",
+    justifyContent: "center",
+    marginRight: 12,
+  },
+  content: {
+    flex: 1,
+  },
+  header: {
+    flexDirection: "row",
+    alignItems: "center",
+    justifyContent: "space-between",
+    marginBottom: 4,
+  },
+  title: {
+    fontSize: 16,
+    fontWeight: "600",
+    flex: 1,
+  },
+  checkmark: {
+    width: 20,
+    height: 20,
+    borderRadius: 10,
+    alignItems: "center",
+    justifyContent: "center",
+    marginLeft: 8,
+  },
+  checkmarkText: {
+    color: "#000",
+    fontSize: 12,
+    fontWeight: "bold",
+  },
+  description: {
+    fontSize: 13,
+    lineHeight: 18,
+  },
+  progressContainer: {
+    marginTop: 8,
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 8,
+  },
+  progressBar: {
+    flex: 1,
+    height: 4,
+    borderRadius: 2,
+    overflow: "hidden",
+  },
+  progressFill: {
+    height: "100%",
+    borderRadius: 2,
+  },
+  progressText: {
+    fontSize: 11,
+    minWidth: 40,
+    textAlign: "right",
+  },
+});

package/src/components/AchievementToast.tsx

@@ -0,0 +1,122 @@
+/**
+ * AchievementToast Component
+ * Shows achievement unlock notification - all text via props
+ */
+
+import React, { useEffect, useRef } from "react";
+import { View, Text, StyleSheet, Animated, type ViewStyle, type TextStyle } from "react-native";
+
+export interface AchievementToastProps {
+  visible: boolean;
+  title: string;
+  label: string; // e.g., "Achievement Unlocked!" - from app translations
+  icon: React.ReactNode;
+  onDismiss: () => void;
+  duration?: number;
+  // Customization
+  containerStyle?: ViewStyle;
+  labelStyle?: TextStyle;
+  titleStyle?: TextStyle;
+  // Colors
+  backgroundColor?: string;
+  textColor?: string;
+  labelColor?: string;
+}
+
+export const AchievementToast: React.FC<AchievementToastProps> = ({
+  visible,
+  title,
+  label,
+  icon,
+  onDismiss,
+  duration = 3000,
+  containerStyle,
+  labelStyle,
+  titleStyle,
+  backgroundColor = "#FFD700",
+  textColor = "#000000",
+  labelColor = "#00000080",
+}) => {
+  const translateY = useRef(new Animated.Value(-100)).current;
+
+  useEffect(() => {
+    if (visible) {
+      Animated.sequence([
+        Animated.timing(translateY, {
+          toValue: 0,
+          duration: 400,
+          useNativeDriver: true,
+        }),
+        Animated.delay(duration),
+        Animated.timing(translateY, {
+          toValue: -100,
+          duration: 300,
+          useNativeDriver: true,
+        }),
+      ]).start(() => {
+        onDismiss();
+      });
+    }
+  }, [visible, duration, onDismiss, translateY]);
+
+  if (!visible) return null;
+
+  return (
+    <Animated.View
+      style={[
+        styles.container,
+        { transform: [{ translateY }] },
+        containerStyle,
+      ]}
+    >
+      <View style={[styles.toast, { backgroundColor }]}>
+        <View style={styles.iconContainer}>{icon}</View>
+        <View style={styles.content}>
+          <Text style={[styles.label, { color: labelColor }, labelStyle]}>
+            {label}
+          </Text>
+          <Text style={[styles.title, { color: textColor }, titleStyle]}>
+            {title}
+          </Text>
+        </View>
+      </View>
+    </Animated.View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    position: "absolute",
+    top: 60,
+    left: 16,
+    right: 16,
+    zIndex: 1000,
+  },
+  toast: {
+    flexDirection: "row",
+    alignItems: "center",
+    padding: 16,
+    borderRadius: 16,
+    gap: 12,
+  },
+  iconContainer: {
+    width: 40,
+    height: 40,
+    justifyContent: "center",
+    alignItems: "center",
+  },
+  content: {
+    flex: 1,
+  },
+  label: {
+    fontSize: 12,
+    fontWeight: "bold",
+    textTransform: "uppercase",
+    letterSpacing: 1,
+  },
+  title: {
+    fontSize: 16,
+    fontWeight: "600",
+    marginTop: 2,
+  },
+});