CODEX - AI-Powered Chat Assistant

CODEX is a modern, responsive MVP web app that serves as an AI-powered chat assistant with file-based reasoning (RAG). Built with React Native and Expo, it provides a clean, minimal, and visually appealing interface for intelligent conversations.

Features

🎨 Modern Design

• Clean, minimal interface inspired by modern chat applications
• Smooth animations and transitions
• Mobile-first responsive design
• Professional typography and spacing

🚀 Smart App Flow

• Splash Screen: Always shows on app launch with fade-in animation
• Onboarding: First-time setup for personalized experience
• Chat Interface: Main screen with ChatGPT-like interface
• Persistent Data: Remembers user and chat history

🤖 AI Integration

• Simulated AI responses with context awareness
• File upload support (PDF, TXT, CSV)
• RAG-enhanced responses when files are uploaded
• Loading states and typing indicators

📁 File Management

• Upload and manage multiple files
• File metadata display (name, size, type)
• Enhanced AI responses based on uploaded content
• Secure local storage

Getting Started

Prerequisites

• Node.js (v16 or higher)
• Expo CLI
• Android Studio (for Android development) or Xcode (for iOS)

Installation

1. Clone the repository

   git clone <repository-url>
   cd codex

2. Install dependencies

   bun install
   # or
   npm install

3. Start the development server

   # For online mode
   bun run start
   
   # For offline mode (recommended if network issues)
   EXPO_OFFLINE=1 bun run start

4. Run on devices

   # Android
   bun run android
   
   # iOS
   bun run ios
   
   # Web
   bun run web

Project Structure

app/
├── _layout.tsx          # Root layout with navigation setup
├── index.tsx            # Splash screen with loading animation
├── onboarding.tsx       # First-time user setup
└── chat.tsx             # Main chat interface

components/              # Reusable UI components (if needed)
assets/                  # Images and static assets
constants/               # App constants and themes

Technical Stack

• Framework: React Native with Expo
• Navigation: Expo Router (file-based routing)
• Storage: AsyncStorage for local data persistence
• File Handling: react-native-document-picker
• Icons: Expo Vector Icons (Ionicons)
• Styling: React Native StyleSheet (modern design system)

Design System

Colors

• Primary: #3B82F6 (Blue-500)
• Text Primary: #111827 (Gray-900)
• Text Secondary: #6B7280 (Gray-500)
• Background: #FFFFFF (White)
• Surface: #F3F4F6 (Gray-100)
• Border: #E5E7EB (Gray-200)

Development Tips

1. Offline Mode: Use EXPO_OFFLINE=1 if experiencing network issues
2. Hot Reloading: Save files to see changes immediately
3. Debugging: Use console.log and React Developer Tools
4. Testing: Test on both iOS and Android for consistency

License

This project is licensed under the MIT License.