Skip to content

README.md

Latest commit

 

History

History
78 lines (57 loc) · 2.41 KB

README.md

File metadata and controls

78 lines (57 loc) · 2.41 KB
Raw

Eventure - Adventure Discovery App 🗺️

A streamlined React Native app built with Expo that helps users discover exciting adventures and activities in their area.

Features

  • 🎯 AI-Powered Adventure Generation: Get personalized adventure suggestions based on mood, time, and budget
  • 📍 Location-Based Discovery: Find adventures near your current location
  • 🏆 Gamification: Track streaks, earn badges, and level up
  • 👥 Social Features: Connect with friends and share adventures
  • 💾 Memory Capsule: Save your favorite adventures for later

Tech Stack

  • Frontend: React Native with Expo
  • Navigation: Expo Router with file-based routing
  • UI Components: Custom components with LinearGradient
  • Backend: Python Flask API
  • Database: SQLite
  • AI Integration: Groq API for adventure generation

Get Started

  1. Install dependencies

    npm install

  2. Set up your Groq API key

    • Get your API key from Groq Console
    • Update app.json with your actual API key:
    "extra": {
  "groqApiKey": "your_actual_api_key_here"
}

  3. Start the development server

    npx expo start

  4. Open the app in your preferred environment:

Project Structure

├── app/                    # Main app screens (Expo Router)
├── components/             # Reusable UI components
├── services/              # API and AI services
├── types/                 # TypeScript type definitions
├── backend/               # Python Flask backend
└── assets/                # Images and fonts

Recent Improvements

  • ✅ Removed unused dependencies (expo-maps, react-native-maps, etc.)
  • ✅ Consolidated UI components for better maintainability
  • ✅ Enhanced .gitignore with comprehensive patterns
  • ✅ Optimized bundle size and performance
  • ✅ Cleaned up code structure and imports

Learn More

Contributing

This project is part of the Cool repository collection. Feel free to explore and contribute!