chore(release): v3.1.0 - [CU-869bebnqf] (#258)

Author: AhmedSobhy01

README.md

@@ -1 +1,261 @@
-# Cross Platform
+<div align="center">
+  <img src="https://cdn.raven.cmp27.space/light-raven.png" alt="Raven Logo" width="150" height="150">
+
+# Raven Mobile App
+
+**Caw Your Thoughts**
+
+A modern, cross-platform social media application built with React Native and Expo.
+
+[![React Native](https://img.shields.io/badge/React%20Native-0.81.5-61DAFB?logo=react)](https://reactnative.dev/)
+[![Expo](https://img.shields.io/badge/Expo-SDK%2054-000020?logo=expo)](https://expo.dev/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript)](https://www.typescriptlang.org/)
+
+</div>
+
+## Features
+
+### Authentication & Security
+
+- **Email/Password Authentication** - Secure sign-up and sign-in with email verification
+- **OAuth Integration** - Third-party authentication support
+- **Password Recovery** - Forgot password flow with email-based reset
+- **Multi-Account Support** - Account switcher for managing multiple profiles
+- **Secure Token Storage** - Uses Expo Secure Store for sensitive data
+
+### Timeline & Feed
+
+- **Home Timeline** - Personalized feed with posts from followed users
+- **Real-time Updates** - Live feed updates via Server-Sent Events (SSE)
+- **Infinite Scrolling** - Cursor-based pagination for smooth scrolling
+- **Pull-to-Refresh** - Refresh feed with pull gesture
+
+### Tweets/Posts
+
+- **Tweet Composer** - Rich text editor with support for:
+  - Hashtag and mention highlighting
+  - Emoji picker integration
+  - Media attachments (up to 4 images/videos per tweet)
+- **Quote Tweets** - Retweet with your own commentary
+- **Reply Threads** - Nested conversation threads
+- **Tweet Actions** - Like, retweet, quote, and reply
+- **Media Grid** - Responsive media display for images and videos
+
+### Direct Messaging
+
+- **Real-time Chat** - Instant messaging with Socket.IO
+- **Message Reactions** - React to messages with emojis
+- **Image Sharing** - Send and view images in conversations
+- **Message Deletion** - Delete sent messages
+- **Conversation List** - View all active conversations
+
+### Explore & Discovery
+
+- **For You** - Curated content discovery
+- **Trending Topics** - Popular hashtags and trends
+- **Category Sections** - Browse by category (News, Sports, Entertainment)
+- **User Search** - Find users by name or username
+- **Tweet Search** - Search content with filters
+
+### Search
+
+- **Advanced Filters** - Filter by users, tweets, hashtags
+- **Recent Searches** - Quick access to search history
+- **Real-time Results** - Instant search suggestions
+
+### Profile Management
+
+- **Profile Customization** - Edit display name, bio, location, website
+- **Profile Picture** - Upload and crop profile images
+- **Header Image** - Custom profile banner
+- **Following/Followers** - View and manage connections
+- **Profile Tabs** - View tweets, replies, media, and likes
+
+### Notifications
+
+- **Push Notifications** - Firebase Cloud Messaging integration
+- **In-App Notifications** - Real-time notification feed
+- **Notification Types** - Likes, retweets, mentions, follows, replies
+
+### Settings & Privacy
+
+- **Appearance** - Theme customization (light/dark mode)
+- **Account Settings** - Manage account information
+- **Privacy Controls**:
+  - Muted accounts management
+  - Blocked accounts management
+  - Content preferences
+  - Interest customization
+
+## Tech Stack
+
+### Core
+
+- **React Native** 0.81.5
+- **Expo** SDK 54
+- **TypeScript** 5.9
+
+### State Management
+
+- **Zustand** - Lightweight state management
+- **TanStack Query** (React Query) - Server state and caching
+
+### Styling
+
+- **NativeWind** 4 - TailwindCSS for React Native
+- **TailwindCSS** 3.4
+
+### Navigation
+
+- **React Navigation** 7 - Stack, Tab, Drawer, and Material Top Tabs
+
+### Real-time
+
+- **Socket.IO Client** - WebSocket-based real-time messaging
+- **React Native SSE** - Server-Sent Events for live updates
+
+### Media
+
+- **Expo Image** - High-performance image component
+- **Expo Image Picker** - Camera and gallery access
+- **Expo Video** - Video playback with Picture-in-Picture
+- **Expo Media Library** - Save and access device media
+
+### Testing
+
+- **Jest** - Unit testing framework
+- **Testing Library** - React Native testing utilities
+- **WebdriverIO** - End-to-end testing
+- **Appium** - Mobile automation
+- **MSW** - API mocking
+
+### Other Notable Libraries
+
+- **Shopify FlashList** - High-performance lists
+- **Lucide Icons** - Modern icon set
+- **React Native Gesture Handler** - Touch gestures
+- **React Native Popover View** - Contextual menus
+- **RN Emoji Keyboard** - Native emoji picker
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18+
+- pnpm
+- Expo CLI
+- Android Studio (for Android development)
+- Xcode (for iOS development, macOS only)
+
+### Installation
+
+1. Clone the repository:
+
+   ```bash
+   git clone https://github.com/Exo1i/raven-cross-platform
+   cd raven
+   ```
+
+2. Install dependencies:
+
+   ```bash
+   pnpm install
+   ```
+
+3. Set up environment variables:
+
+   ```bash
+   cp .env.example .env
+   ```
+
+   Edit `.env` with your configuration values.
+
+4. Start the development server:
+
+   ```bash
+   pnpm start
+   ```
+
+### Running on Devices
+
+```bash
+# Android
+pnpm android
+
+# iOS
+pnpm ios
+```
+
+### Building
+
+Debug builds:
+
+```bash
+./build-debug.sh
+```
+
+Release builds:
+
+```bash
+./build-release.sh
+```
+
+## Scripts
+
+| Command         | Description                    |
+| --------------- | ------------------------------ |
+| `pnpm start`    | Start Expo development server  |
+| `pnpm android`  | Run on Android device/emulator |
+| `pnpm ios`      | Run on iOS device/simulator    |
+| `pnpm web`      | Run in web browser             |
+| `pnpm test`     | Run tests in watch mode        |
+| `pnpm test:cov` | Run tests with coverage        |
+| `pnpm e2e`      | Run end-to-end tests           |
+
+## Configuration
+
+### EAS Build
+
+The project uses Expo Application Services (EAS) for building. Configuration is in `eas.json`:
+
+- **Development** - Debug builds for development
+- **Preview** - Internal testing builds
+- **Production** - Release builds for app stores
+
+### Firebase
+
+Push notifications require Firebase configuration:
+
+1. Create a Firebase project
+2. Add `google-services.json` for Android
+3. Set `GOOGLE_SERVICES_JSON` environment variable for CI/CD
+
+## Licenses
+
+### Fonts
+
+- **Inter** - The app uses the [Inter font family](https://fonts.google.com/specimen/Inter) by Rasmus Andersson, licensed under the [SIL Open Font License 1.1](https://scripts.sil.org/OFL).
+
+### Icons
+
+- **Lucide Icons** - Licensed under the [ISC License](https://github.com/lucide-icons/lucide/blob/main/LICENSE).
+- **Ionicons** - Licensed under the [MIT License](https://github.com/ionic-team/ionicons/blob/main/LICENSE).
+- **Expo Vector Icons** - A collection of icon sets, each with their respective licenses.
+
+### Images
+
+- App logo and splash screen images are original assets created for this project.
+- User-uploaded content is subject to the platform's terms of service.
+
+### Code Quality
+
+The project enforces code quality with:
+
+- **ESLint** - Linting with Expo and TypeScript rules
+- **Prettier** - Code formatting
+- **Husky** - Git hooks for pre-commit checks
+- **TypeScript** - Strict type checking
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

app.config.js

@@ -39,7 +39,6 @@ export default ({ config }) => ({
 
   plugins: [
     'expo-secure-store',
-    'expo-localization',
     [
       'expo-media-library',
       {

babel.config.js

@@ -2,5 +2,10 @@ module.exports = function (api) {
   api.cache(true);
   return {
     presets: [['babel-preset-expo', { jsxImportSource: 'nativewind' }], 'nativewind/babel'],
+    env: {
+      test: {
+        plugins: ['dynamic-import-node'],
+      },
+    },
   };
 };