create-gufran-expo-app 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Gufran Gaury
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,413 @@
+# 🚀 @gufran/expo-boilerplate
+
+![npm version](https://img.shields.io/npm/v/@gufran/expo-boilerplate.svg)
+![downloads](https://img.shields.io/npm/dt/@gufran/expo-boilerplate.svg)
+![license](https://img.shields.io/npm/l/@gufran/expo-boilerplate.svg)
+
+**Ultimate Expo React Native Boilerplate** - A professionally configured Expo environment designed for production-ready applications. Skip the tedious setup and dive straight into building amazing features!
+
+---
+
+## ✨ Why Choose This Boilerplate?
+
+This boilerplate provides a complete, production-ready setup with enterprise-grade features:
+
+- 🔥 **Firebase Integration** - Authentication, Push Notifications, Analytics
+- 🎨 **Professional UI** - Pre-built components and screens
+- 🗂️ **Clean Architecture** - Organized folder structure that scales
+- ☁️ **Cloud Storage** - Azure Blob Storage for file uploads
+- 🔐 **Authentication Flow** - Complete auth screens and navigation
+- 📱 **Native Features** - Camera, Image Picker, Permissions
+- 🔔 **Push Notifications** - Notifee and Firebase Messaging
+- 🌐 **API Management** - TanStack Query configured
+- 📊 **State Management** - Zustand for efficient state handling
+- 🎯 **TypeScript** - Full type safety
+
+---
+
+## 🚀 Quick Start
+
+Create a new project with a single command:
+
+```bash
+npx @gufran/expo-boilerplate my-awesome-app
+```
+
+Or use npm directly:
+
+```bash
+npm create @gufran/expo-boilerplate my-awesome-app
+```
+
+With yarn:
+
+```bash
+yarn create @gufran/expo-boilerplate my-awesome-app
+```
+
+### Interactive Mode
+
+Simply run without a project name to enter interactive mode (will prompt for project name and bundle ID):
+
+```bash
+npx @gufran/expo-boilerplate
+```
+
+---
+
+## 📋 Command Options
+
+```bash
+npx @gufran/expo-boilerplate [project-name] [options]
+```
+
+### Options:
+
+| Option | Description |
+|--------|-------------|
+| `-b, --bundle-id <bundleId>` | Bundle identifier (e.g., com.myapp) |
+| `--skip-install` | Skip automatic dependency installation |
+| `--skip-git` | Skip git initialization |
+| `--npm` | Use npm instead of yarn |
+| `-h, --help` | Display help information |
+| `-V, --version` | Display version number |
+
+### Examples:
+
+```bash
+# Create project with custom bundle ID
+npx @gufran/expo-boilerplate my-app -b com.myapp
+
+# Create project with npm
+npx @gufran/expo-boilerplate my-app --npm
+
+# Skip installation and git init
+npx @gufran/expo-boilerplate my-app --skip-install --skip-git
+
+# Full command with all options
+npx @gufran/expo-boilerplate my-app -b com.myapp --npm
+
+# Interactive mode (prompts for name and bundle ID)
+npx @gufran/expo-boilerplate
+```
+
+---
+
+## 📦 What's Included?
+
+### 🎯 Core Technologies
+
+- **Expo SDK 54** - Latest Expo framework
+- **React Native 0.81** - Latest stable RN version
+- **TypeScript** - Full type safety
+- **React Navigation 7** - Native stack navigation
+
+### 🔥 Firebase Services
+
+- Firebase App & Messaging
+- Push Notifications with Notifee
+- Cloud Messaging
+- Analytics ready
+
+### 💾 State & Data Management
+
+- **Zustand** - Lightweight state management
+- **TanStack Query** - Server state management
+- **MMKV** - Fast local storage
+- **React Native Gesture Handler** - Smooth gestures
+
+### 🎨 UI & Media
+
+- Image Picker & Camera
+- Image Zoom capabilities
+- SVG support
+- Reanimated animations
+- Keyboard-aware scrolling
+
+
+### ☁️ Cloud Services
+
+- Azure Blob Storage integration
+- Background file upload
+- Progress tracking
+
+### 🔐 Authentication
+
+- Complete auth flow
+- Context-based auth management
+- Secure storage
+
+---
+
+## 📁 Project Structure
+
+```
+my-app/
+├── src/
+│   ├── assets/          # Images, fonts, icons
+│   ├── components/      # Reusable UI components
+│   │   └── common/      # Common components
+│   ├── config/          # App configuration
+│   ├── constants/       # Constants, themes, strings
+│   ├── contexts/        # React contexts (Auth, etc.)
+│   ├── hooks/           # Custom React hooks
+│   ├── navigation/      # Navigation setup
+│   │   ├── AuthStack.tsx
+│   │   ├── MainStack.tsx
+│   │   └── RootNavigator.tsx
+│   ├── screens/         # App screens
+│   │   ├── auth/        # Authentication screens
+│   │   ├── chat/        # Chat features
+│   │   ├── clubs/       # Club management
+│   │   ├── events/      # Events
+│   │   └── ...
+│   ├── services/        # API services
+│   ├── stores/          # Zustand stores
+│   ├── types/           # TypeScript types
+│   └── utils/           # Utility functions
+├── android/             # Android native code
+├── ios/                 # iOS native code
+├── FirebaseFiles/       # Firebase configuration files
+└── assets/              # Root assets
+```
+
+---
+
+## 🛠️ Setup Steps
+
+### 1. Create Your Project
+
+```bash
+# Interactive mode (recommended)
+npx @gufran/expo-boilerplate
+
+# Or specify project name and bundle ID
+npx @gufran/expo-boilerplate my-app -b com.myapp
+
+cd my-app
+```
+
+The CLI will automatically:
+- Create project directory
+- Copy all template files (no git clone needed!)
+- Update `package.json` with your project name
+- Update `app.json` with your project name and bundle IDs
+- Install dependencies (unless --skip-install)
+- Initialize git repository (unless --skip-git)
+
+### 2. Configure Firebase
+
+Add your Firebase configuration files:
+
+**For Android:**
+```bash
+# Add google-services.json to:
+android/app/google-services.json
+```
+
+**For iOS:**
+```bash
+# Add GoogleService-Info.plist to:
+ios/ClubYakka/GoogleService-Info.plist
+```
+
+### 3. Install iOS Dependencies
+
+```bash
+cd ios && pod install && cd ..
+```
+
+### 4. Verify Configuration
+
+The CLI automatically updates `app.json` with your bundle IDs, but you can verify:
+
+```json
+{
+  "expo": {
+    "name": "my-app",
+    "slug": "my-app",
+    "version": "1.0.0",
+    "ios": {
+      "bundleIdentifier": "com.myapp"
+    },
+    "android": {
+      "package": "com.myapp"
+    }
+  }
+}
+```
+
+### 5. Start Development
+
+```bash
+# Start Metro bundler
+npm start
+
+# Run on Android
+npm run android
+
+# Run on iOS
+npm run ios
+```
+
+---
+
+## 🔧 Available Scripts
+
+| Script | Description |
+|--------|-------------|
+| `npm start` | Start Metro bundler |
+| `npm run android` | Run on Android device/emulator |
+| `npm run ios` | Run on iOS device/simulator |
+| `npm run web` | Run on web browser |
+| `npm run pod` | Install iOS pods |
+| `npm run clear` | Clear Metro cache |
+| `npm run clean` | Clean Android build |
+
+---
+
+## 🎨 Key Features Explained
+
+### Authentication Flow
+
+Complete authentication system with:
+- Login/Register screens
+- OTP verification
+- Password reset
+- Protected routes
+- Auth context management
+
+### Navigation Structure
+
+Three-level navigation:
+1. **RootNavigator** - Entry point
+2. **AuthStack** - Unauthenticated screens
+3. **MainStack** - Authenticated screens
+
+### API Integration
+
+Pre-configured with:
+- Axios for HTTP requests
+- TanStack Query for caching
+- Error handling
+- Request/response interceptors
+
+### File Upload
+
+Background upload with:
+- Azure Blob Storage integration
+- Progress tracking
+- Multiple file support
+- Error handling
+
+### Push Notifications
+
+Complete notification system:
+- Firebase Cloud Messaging
+- Notifee for local notifications
+- Permission handling
+- Deep linking support
+
+---
+
+## 🔐 Environment Setup
+
+Create `.env` file in root:
+
+```env
+API_BASE_URL=https://api.yourapp.com
+AZURE_STORAGE_URL=your-azure-url
+SQUARE_APPLICATION_ID=your-square-id
+```
+
+---
+
+## 📱 Platform-Specific Notes
+
+### iOS
+
+- Requires Xcode 14+
+- Run `pod install` after installing dependencies
+- Configure signing in Xcode
+- Update `Info.plist` with required permissions
+
+### Android
+
+- Requires Android Studio
+- Update `google-services.json`
+- Configure signing in `android/app/build.gradle`
+- Set up keystore for release builds
+
+---
+
+## 🧪 Testing
+
+```bash
+# Run tests (when configured)
+npm test
+
+# Type checking
+npx tsc --noEmit
+```
+
+---
+
+## 📚 Documentation
+
+For detailed documentation on specific features:
+
+- [Firebase Setup](./docs/firebase.md)
+- [Azure Storage](./docs/azure-storage.md)
+- [Navigation Guide](./docs/navigation.md)
+- [API Services](./docs/api-services.md)
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+---
+
+## 🐛 Issues
+
+Found a bug? Please [open an issue](https://github.com/GufranGaury1887/Boiler_Plat_Expo_-Gufran/issues) with a detailed description.
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 👤 Author
+
+**Gufran Gaury**
+
+- GitHub: [@GufranGaury1887](https://github.com/GufranGaury1887)
+- Repository: [Boiler_Plat_Expo_-Gufran](https://github.com/GufranGaury1887/Boiler_Plat_Expo_-Gufran)
+
+---
+
+## 🌟 Show Your Support
+
+Give a ⭐️ if this project helped you!
+
+---
+
+## 📮 Support
+
+For support, email your-email@example.com or open an issue on GitHub.
+
+---
+
+**Built with ❤️ by Gufran Gaury**
+
+*Happy Coding! 🚀*

package/bin/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const { createExpoApp } = require('../lib/createApp');
+const packageJson = require('../package.json');
+
+console.log(chalk.cyan.bold(`
+╔═══════════════════════════════════════════════════════════╗
+║                                                           ║
+║   🚀 Gufran's Expo Boilerplate Generator 🚀              ║
+║                                                           ║
+║   Create production-ready Expo apps in seconds!          ║
+║                                                           ║
+╚═══════════════════════════════════════════════════════════╝
+`));
+
+program
+  .version(packageJson.version)
+  .description('Create a new Expo app using Gufran\'s professional boilerplate')
+  .argument('[project-name]', 'Name of your new project')
+  .option('-b, --bundle-id <bundleId>', 'Bundle identifier (e.g., com.company.appname)')
+  .option('-t, --template <template>', 'Template variant to use', 'default')
+  .option('--skip-install', 'Skip dependency installation')
+  .option('--skip-git', 'Skip git initialization')
+  .option('--npm', 'Use npm instead of yarn')
+  .action(async (projectName, options) => {
+    try {
+      await createExpoApp(projectName, options);
+    } catch (error) {
+      console.error(chalk.red('\n❌ Error creating project:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program.parse(process.argv);

package/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+// This is the main entry point that will be executed when installed globally
+require('./bin/cli.js');

package/lib/createApp.js

@@ -0,0 +1,324 @@
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const ora = require('ora');
+const prompts = require('prompts');
+const validateProjectName = require('validate-npm-package-name');
+
+/**
+ * Execute command with proper error handling
+ */
+function executeCommand(command, options = {}) {
+  try {
+    execSync(command, {
+      stdio: options.silent ? 'pipe' : 'inherit',
+      ...options
+    });
+    return true;
+  } catch (error) {
+    if (!options.ignoreError) {
+      throw error;
+    }
+    return false;
+  }
+}
+
+/**
+ * Check if command exists
+ */
+function commandExists(command) {
+  try {
+    execSync(`command -v ${command}`, { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Validate project name
+ */
+function validateName(name) {
+  const validation = validateProjectName(name);
+  if (!validation.validForNewPackages) {
+    const errors = [
+      ...(validation.errors || []),
+      ...(validation.warnings || [])
+    ];
+    throw new Error(`Invalid project name: ${errors.join(', ')}`);
+  }
+}
+
+/**
+ * Generate bundle identifier
+ */
+function generateBundleId(projectName, bundleIdPrefix) {
+  const cleanName = projectName.toLowerCase().replace(/[^a-z0-9]/g, '');
+  return `${bundleIdPrefix}.${cleanName}`;
+}
+
+/**
+ * Copy directory recursively
+ */
+function copyDirectory(src, dest, excludeDirs = []) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    // Skip excluded directories
+    if (excludeDirs.includes(entry.name)) {
+      continue;
+    }
+
+    if (entry.isDirectory()) {
+      copyDirectory(srcPath, destPath, excludeDirs);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * Copy template files and update configurations
+ */
+function copyTemplateFiles(templatePath, projectPath, appName, bundleId) {
+  // Directories to exclude from copying
+  const excludeDirs = [
+    'node_modules',
+    '.git',
+    'cli-package',
+    'build',
+    'ios/build',
+    'android/build',
+    'android/.gradle',
+    '.expo',
+    'dist',
+    'Pods',
+    'ios/Pods',
+    '.idea',
+    'ios/ClubYakka.xcworkspace/xcuserdata',
+    'ios/ClubYakka.xcodeproj/xcuserdata'
+  ];
+
+  // Copy all files except excluded directories
+  copyDirectory(templatePath, projectPath, excludeDirs);
+}
+
+/**
+ * Main function to create the Expo app
+ */
+async function createExpoApp(projectName, options) {
+  let appName = projectName;
+  let bundleId = options.bundleId;
+
+  // Prompt for project name and bundle ID if not provided
+  if (!appName || !bundleId) {
+    const responses = await prompts([
+      {
+        type: 'text',
+        name: 'projectName',
+        message: 'What is your project name?',
+        initial: appName || 'my-expo-app',
+        validate: (value) => {
+          if (!value) return 'Project name is required';
+          const validation = validateProjectName(value);
+          if (!validation.validForNewPackages) {
+            const errors = [
+              ...(validation.errors || []),
+              ...(validation.warnings || [])
+            ];
+            return errors.join(', ');
+          }
+          return true;
+        }
+      },
+      {
+        type: 'text',
+        name: 'bundleId',
+        message: 'What is your bundle identifier? (e.g., com.appname)',
+        initial: (prev) => bundleId || generateBundleId(prev, 'com'),
+        validate: (value) => {
+          if (!value) return 'Bundle ID is required';
+          if (!/^[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)+$/i.test(value)) {
+            return 'Invalid bundle ID format. Use format: com.company.appname';
+          }
+          return true;
+        }
+      }
+    ]);
+
+    if (!responses.projectName || !responses.bundleId) {
+      console.log(chalk.red('\n❌ Project creation cancelled'));
+      process.exit(1);
+    }
+
+    appName = responses.projectName;
+    bundleId = responses.bundleId;
+  }
+
+  // Validate project name
+  validateName(appName);
+
+  const projectPath = path.resolve(process.cwd(), appName);
+
+  // Check if directory already exists
+  if (fs.existsSync(projectPath)) {
+    console.log(chalk.red(`\n❌ Directory "${appName}" already exists!`));
+    process.exit(1);
+  }
+
+  console.log(chalk.green(`\n✨ Creating a new Expo app: ${chalk.bold(appName)}`));
+  console.log(chalk.cyan(`📦 Bundle ID: ${chalk.bold(bundleId)}\n`));
+
+  // Check for Node.js
+  let spinner = ora('Checking prerequisites...').start();
+  if (!commandExists('node')) {
+    spinner.fail('Node.js is not installed. Please install Node.js and try again.');
+    process.exit(1);
+  }
+  spinner.succeed('Prerequisites check passed');
+
+  // Create project directory
+  spinner = ora('Creating project directory...').start();
+  try {
+    fs.mkdirSync(projectPath, { recursive: true });
+    spinner.succeed('Project directory created');
+  } catch (error) {
+    spinner.fail('Failed to create project directory');
+    throw error;
+  }
+
+  // Copy template files from current directory (the boilerplate itself)
+  spinner = ora('Copying template files...').start();
+  try {
+    const templatePath = path.resolve(__dirname, '../../');
+    copyTemplateFiles(templatePath, projectPath, appName, bundleId);
+    spinner.succeed('Template files copied successfully');
+  } catch (error) {
+    spinner.fail('Failed to copy template files');
+    throw error;
+  }
+
+  // Update package.json
+  spinner = ora('Updating package.json...').start();
+  const packageJsonPath = path.join(projectPath, 'package.json');
+  if (fs.existsSync(packageJsonPath)) {
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+    packageJson.name = appName;
+    packageJson.version = '1.0.0';
+    fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+    spinner.succeed('package.json updated');
+  } else {
+    spinner.warn('package.json not found, skipping update');
+  }
+
+  // Update app.json
+  spinner = ora('Updating app.json...').start();
+  const appJsonPath = path.join(projectPath, 'app.json');
+  if (fs.existsSync(appJsonPath)) {
+    const appJson = JSON.parse(fs.readFileSync(appJsonPath, 'utf-8'));
+    if (appJson.expo) {
+      appJson.expo.name = appName;
+      appJson.expo.slug = appName.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+      
+      // Update bundle identifiers
+      if (appJson.expo.ios) {
+        appJson.expo.ios.bundleIdentifier = bundleId;
+      } else {
+        appJson.expo.ios = { bundleIdentifier: bundleId };
+      }
+      
+      if (appJson.expo.android) {
+        appJson.expo.android.package = bundleId;
+      } else {
+        appJson.expo.android = { package: bundleId };
+      }
+    }
+    fs.writeFileSync(appJsonPath, JSON.stringify(appJson, null, 2));
+    spinner.succeed('app.json updated with bundle IDs');
+  } else {
+    spinner.warn('app.json not found, skipping update');
+  }
+
+  // Install dependencies
+  if (!options.skipInstall) {
+    const useYarn = !options.npm && commandExists('yarn');
+    const packageManager = useYarn ? 'yarn' : 'npm';
+    
+    spinner = ora(`Installing dependencies with ${packageManager}...`).start();
+    spinner.text = `Installing dependencies... This might take a few minutes ☕`;
+    
+    try {
+      executeCommand(`cd "${projectPath}" && ${packageManager} install`);
+      spinner.succeed('Dependencies installed successfully');
+    } catch (error) {
+      spinner.fail('Failed to install dependencies');
+      console.log(chalk.yellow('\nYou can install dependencies later by running:'));
+      console.log(chalk.cyan(`  cd ${appName} && ${packageManager} install\n`));
+    }
+  }
+
+  // Initialize git
+  if (!options.skipGit) {
+    spinner = ora('Initializing git repository...').start();
+    try {
+      executeCommand(`cd "${projectPath}" && git init`, { silent: true });
+      executeCommand(`cd "${projectPath}" && git add -A`, { silent: true });
+      executeCommand(`cd "${projectPath}" && git commit -m "Initial commit from @gufran/expo-boilerplate"`, { silent: true });
+      spinner.succeed('Git repository initialized');
+    } catch (error) {
+      spinner.warn('Git initialization skipped');
+    }
+  }
+
+  // Success message
+  console.log(chalk.green.bold('\n🎉 Success! Your Expo app is ready!\n'));
+  console.log(chalk.cyan('📁 Project created at:'), chalk.bold(projectPath));
+  console.log(chalk.cyan('\n📚 Next steps:\n'));
+  console.log(chalk.white(`  ${chalk.bold('1.')} Navigate to your project:`));
+  console.log(chalk.gray(`     cd ${appName}\n`));
+  
+  if (options.skipInstall) {
+    console.log(chalk.white(`  ${chalk.bold('2.')} Install dependencies:`));
+    console.log(chalk.gray(`     npm install\n`));
+  }
+
+  console.log(chalk.white(`  ${chalk.bold(options.skipInstall ? '3' : '2')}. Configure Firebase:`));
+  console.log(chalk.gray(`     - Add your google-services.json to android/app/`));
+  console.log(chalk.gray(`     - Add your GoogleService-Info.plist to ios/ClubYakka/\n`));
+
+  console.log(chalk.white(`  ${chalk.bold(options.skipInstall ? '4' : '3')}. Install iOS dependencies:`));
+  console.log(chalk.gray(`     cd ios && pod install && cd ..\n`));
+
+  console.log(chalk.white(`  ${chalk.bold(options.skipInstall ? '5' : '4')}. Start the development server:`));
+  console.log(chalk.gray(`     npm start\n`));
+
+  console.log(chalk.white(`  ${chalk.bold(options.skipInstall ? '6' : '5')}. Run on device:`));
+  console.log(chalk.gray(`     npm run android  ${chalk.dim('# For Android')}`));
+  console.log(chalk.gray(`     npm run ios      ${chalk.dim('# For iOS')}\n`));
+
+  console.log(chalk.cyan('📖 Features included:'));
+  console.log(chalk.gray('   ✅ React Navigation with Authentication Flow'));
+  console.log(chalk.gray('   ✅ Firebase Integration (Messaging, Analytics)'));
+  console.log(chalk.gray('   ✅ Azure Blob Storage Upload'));
+  console.log(chalk.gray('   ✅ TanStack Query for API Management'));
+  console.log(chalk.gray('   ✅ TypeScript Configuration'));
+  console.log(chalk.gray('   ✅ Zustand State Management'));
+  console.log(chalk.gray('   ✅ Image Picker & Camera Integration'));
+  console.log(chalk.gray('   ✅ Push Notifications with Notifee\n'));
+
+  console.log(chalk.yellow('⚠️  Important:'));
+  console.log(chalk.gray('   Remember to update your app.json with your own configuration'));
+  console.log(chalk.gray('   and add your Firebase configuration files!\n'));
+
+  console.log(chalk.magenta('💡 Happy coding! 🚀\n'));
+}
+
+module.exports = { createExpoApp };

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "create-gufran-expo-app",
+  "version": "2.0.0",
+  "description": "🚀 Ultimate Expo React Native Boilerplate - Create production-ready Expo apps instantly with Firebase, Navigation, TypeScript, and more. No git clone needed, works offline!",
+  "main": "index.js",
+  "bin": {
+    "create-gufran-expo-app": "./bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepare": "chmod +x bin/cli.js"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "boilerplate",
+    "template",
+    "firebase",
+    "typescript",
+    "react-navigation",
+    "azure-storage",
+    "starter-kit",
+    "gufran"
+  ],
+  "author": "Gufran Gaury <your-email@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GufranGaury1887/Boiler_Plat_Expo_-Gufran.git"
+  },
+  "bugs": {
+    "url": "https://github.com/GufranGaury1887/Boiler_Plat_Expo_-Gufran/issues"
+  },
+  "homepage": "https://github.com/GufranGaury1887/Boiler_Plat_Expo_-Gufran#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "ora": "^5.4.1",
+    "prompts": "^2.4.2",
+    "validate-npm-package-name": "^5.0.0"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "template",
+    "README.md",
+    "LICENSE"
+  ]
+}