WorldLen

WorldLen is a modern social networking application built with Expo and React Native.

Features

• Authentication: Secure sign-up/login with Supabase and Google Sign-In.
• Explore: Discover new friends with advanced filtering (location, age, interests).
• Chat: Real-time messaging with read receipts and typing indicators.
• Friends: Manage friend requests and view suggestions.
• Profile: Customizable user profiles with interests, occupation, and location.
• Theming: Dark and light mode support.

Tech Stack

• Framework: Expo (React Native)
• Language: TypeScript
• Backend: Supabase (Auth, Database, Realtime)
• State Management: Zustand
• Navigation: Expo Router
• Styling: StyleSheet, Lucide Icons

Getting Started

Prerequisites

• Node.js (v18+)
• npm or yarn
• Expo Go app (for mobile testing)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/worldlen.git
   cd worldlen

2. Install dependencies:

   npm install

3. Set up environment variables:

   • Copy .env.example to .env
   • Fill in your Supabase URL and Anon Key

4. Start the development server:

   npm run dev

Scripts

• npm run dev: Start development server
• npm run android: Run on Android emulator/device
• npm run ios: Run on iOS simulator/device
• npm run typecheck: Run TypeScript check
• npm run lint: Run ESLint
• npm run format: Format code with Prettier
• npm run test: Run tests

Project Structure

• app/: Expo Router screens and layouts
• src/components/: Reusable UI components
• src/services/: API services (Auth, Chat, etc.)
• src/hooks/: Custom React hooks
• src/constants/: App constants (Theme, Strings, etc.)
• src/contexts/: React Context providers
• src/utils/: Utility functions
• src/types/: TypeScript type definitions

Contributing

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.