AtAGlance 📱

AI-Powered Location Reviews at a Glance

Get intelligent insights about places through AI-powered sentiment analysis

---

📸 Screenshots

🔐 Login	🗺️ Explore	📍 Map View
📌 Markers	📋 Overview	📊 Insights
📈 Trends	🤖 AI Assistant	🌙 Dark Mode
🤖 AI Chat	👤 Profile

---

✨ Features

🗺️ Smart Location Discovery GPS-based nearby places search Adjustable search radius (500m - 5km) Category filtering (restaurants, cafes, etc.) Interactive map with custom markers	🤖 AI-Powered Analysis Gemini AI sentiment analysis Intelligent review summarization Score breakdown (cleanliness, service, etc.) Natural language insights
📊 Data Visualization Visual score cards with gradients Historical trend charts Rating distribution graphs Color-coded sentiment indicators	🔐 Secure & Fast Firebase Authentication Google Sign-In support Firestore data persistence Real-time updates

---

🛠️ Tech Stack

Category	Technology
Framework	React Native + Expo SDK 52
Navigation	Expo Router (file-based)
Backend	Firebase (Auth + Firestore)
AI/ML	Google Gemini API
Maps	Google Maps + Places API
Charts	react-native-gifted-charts

---

🚀 Getting Started

Prerequisites

• Node.js 18+
• Yarn package manager
• Expo CLI
• Firebase project with Auth & Firestore enabled
• Google Cloud project with Places & Gemini APIs

Installation

# Clone the repository
git clone https://github.com/mahavirbha/AtAGlance.git
cd AtAGlance

# Install dependencies
yarn install

# Set up environment variables
cp .env.example .env
# Edit .env with your API keys

# Start development server
yarn start

Environment Variables

Create a .env file with:

GEMINI_API_KEY=your_gemini_api_key
GOOGLE_MAPS_API_KEY=your_google_maps_api_key

---

📁 Project Structure

AtAGlance/
├── app/                    # Expo Router pages
│   ├── (auth)/            # Auth screens (login)
│   ├── (tabs)/            # Tab navigation
│   │   ├── explore.js     # Map & search
│   │   └── profile.js     # User profile
│   └── place-details/     # Place details screen
├── features/              # Feature modules
│   ├── explore/           # Explore components & hooks
│   └── place-details/     # Details components & utils
├── components/            # Shared components
├── context/               # React Context providers
├── scripts/               # API & utility scripts
└── constants/             # App constants & theme

---

🎯 How It Works

1. 🔐 Sign In — Authenticate with email or Google
2. 📍 Allow Location — Grant GPS access for nearby search
3. 🔍 Explore — Browse places on map or list view
4. 📊 Analyze — Tap a place to see AI-powered insights
5. 📈 Track — View sentiment trends over time

---

🤝 Contributing

Contributions are welcome! This project uses Yarn for package management.

yarn add <package>    # Add dependency
yarn start            # Start dev server
yarn android          # Run on Android
yarn ios              # Run on iOS

---

📄 License

This project is open source and available under the MIT License.

---

Built with ❤️ using React Native & Expo

⭐ Star this repo · 🐛 Report Bug · ✨ Request Feature