go-event-alerts

GO Event Alerts

A full-stack mobile application that scrapes, processes, and displays Pokémon GO event information, providing users with local notifications for upcoming events.

Table of Contents

• Project Overview
• Screenshots
• Features
• Technology Stack
• Repository Structure
• Getting Started
• License

Project Overview

This project is a comprehensive system designed to keep Pokémon GO players informed about in-game events. The main product is the Android app available on the Google Play Store.

The system consists of three main components:

1. Python Backend: A data processing pipeline that scrapes event information, uses a series of LLMs to structure the data, and stores it in a cloud database.
2. AWS Serverless Infrastructure: The backend is hosted on a serverless AWS infrastructure, providing scalability and automation.
3. React Native Mobile App: The Android application that displays the event information and allows users to configure and receive local notifications.

For more detailed information on each component, please refer to the README files in their respective directories:

• Backend README
• Mobile App README
• AWS Infrastructure README

Screenshots

Event List (Light)	Event List (Dark)	Configuration

Features

• Automated Event Scraping: Daily scraping of Pokémon GO event information from multiple sources.
• AI-Powered Data Processing: A chain of LLMs are used to convert unstructured event descriptions into clean, structured JSON data.
• Smart Deduplication: A multi-stage deduplication process to avoid redundant data and identify semantic duplicates.
• Cross-Platform Mobile App: A React Native app for Android
• Customizable Local Notifications: Users can configure notifications for the type of events they are interested in.
• Light & Dark Mode: The app respects the user’s system theme.
• Background Data Refresh: Ensures event information and notifications are always up-to-date.

Technology Stack

Backend:

• Python
• requests, beautifulsoup4 for scraping
• openai for LLM integration
• boto3 for AWS integration
• python-dateutil, pytz for timezone handling

Infrastructure:

• AWS Lambda
• AWS DynamoDB
• AWS API Gateway
• AWS EventBridge

Mobile App:

• React Native
• react-native-paper for UI components
• @react-native-async-storage/async-storage for local storage
• react-navigation for navigation
• @notifee/react-native for local notifications
• react-native-background-fetch for background tasks

Repository Structure

go-event-alerts/
├── .gitignore
├── LICENSE.md
├── privacy-policy.md
├── README.md
├── backend/
│   ├── main.py           # Main script to run the pipeline
│   ├── scraper.py
│   ├── ai_processor.py
│   ├── data_cleaner.py
│   ├── cloud.py
│   ├── config.py
│   ├── requirements.txt  # Python dependencies
│   └── README.md
├── mobile-app/
│   ├── android/          # Android native project
│   ├── src/              # React Native source code
│   │   ├── api/
│   │   ├── components/
│   │   ├── context/
│   │   └── screens/
│   ├── backgroundTask.js # Headless JS task for background fetch
│   ├── package.json      # Node.js dependencies
│   └── README.md
└── docs/
    ├── aws/
    │   └── README.md
    └── images/
        ├── screenshot-light.png
        ├── screenshot-dark.png
        └── screenshot-config.png

Getting Started

To get started with this project, you will need to set up the backend, the AWS infrastructure, and the mobile app. Or you could experiment with each part individually. Please refer to the detailed instructions in each component’s README file.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

This site is open source. Improve this page.