cross-platform

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 20 Open GitHub ↗

Cross platform repository for Raven SWE project

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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).

cross-platform

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README