https://github.com/yosef-alsabbah/social-media-follower-dashboard
A full-stack social media analytics dashboard built with React.js and FastAPI. Displays real-time follower counts and growth trends across major platforms with clean, modern Arabic/RTL-friendly UI, Chart.js visualizations, and an async-ready REST API backed by SQLite.
https://github.com/yosef-alsabbah/social-media-follower-dashboard
analytics dashboard fastapi fullstack react social-media
Last synced: about 2 months ago
JSON representation
A full-stack social media analytics dashboard built with React.js and FastAPI. Displays real-time follower counts and growth trends across major platforms with clean, modern Arabic/RTL-friendly UI, Chart.js visualizations, and an async-ready REST API backed by SQLite.
- Host: GitHub
- URL: https://github.com/yosef-alsabbah/social-media-follower-dashboard
- Owner: Yosef-AlSabbah
- Created: 2025-07-15T09:35:44.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-07-20T11:17:15.000Z (3 months ago)
- Last Synced: 2025-07-20T13:04:44.780Z (3 months ago)
- Topics: analytics, dashboard, fastapi, fullstack, react, social-media
- Language: TypeScript
- Homepage:
- Size: 553 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Social-Media-Follower-Dashboard
A full-stack social media analytics dashboard built with React.js and Django. Displays real-time follower counts and growth trends across major platforms with clean, modern Arabic/RTL-friendly UI, Chart.js visualizations, and an async-ready REST API backed by PostgreSQL.
Social Media Follower Dashboard
A full-stack social media analytics dashboard built with React.js and Django. Displays real-time follower counts and growth trends across major platforms with clean, modern Arabic/RTL-friendly UI, Chart.js visualizations, and an async-ready REST API backed by PostgreSQL.
## ✨ Features
- **Real-Time Analytics**: Fetches and displays up-to-date follower counts.
- **Multi-Platform Support**: Tracks Facebook, Twitter, Instagram, and YouTube.
- **Growth Visualization**: Interactive charts showing follower trends over time.
- **Modern Tech Stack**: React.js frontend with a Django backend.
- **Clean, Responsive UI**: Arabic/RTL-friendly design that looks great on any device.
- **Async-Ready API**: Built for performance and scalability with Celery and Redis.
- **Containerized**: Fully containerized with Docker for easy deployment and scaling.
## 🚀 Getting Started
### Prerequisites
- Docker & Docker Compose
### Installation
1. **Clone the repository:**
```bash
git clone https://github.com/RSTAD/Social-Media-Follower-Dashboard.git
cd Social-Media-Follower-Dashboard
```
2. **Create a `.env` file** in the `Backend` directory by copying the example:
```bash
cp Backend/.env.example Backend/.env
```
Update the `.env` file with your desired settings.
3. **Build and run the application:**
```bash
docker-compose up --build
```
4. **Open your browser** and navigate to `http://localhost`.
## 🐳 Docker Services
This project uses Docker to containerize all services for a consistent and reproducible environment.
- **`proxy`**: An Nginx reverse proxy that serves the frontend and routes API requests to the backend.
- **`backend`**: The Django application serving the REST API.
- **`frontend`**: The React.js application.
- **`db`**: A PostgreSQL database for data storage.
- **`redis`**: A Redis instance for caching and as a message broker for Celery.
- **`celery-worker`**: A Celery worker to process asynchronous tasks.
- **`celery-beat`**: A Celery beat scheduler for periodic tasks.
## API Endpoints
- `GET /api/followers`: Returns the latest follower counts for all platforms.
- `GET /api/followers/history`: Returns historical follower data for charts.
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a pull request.
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
This project is licensed under the MIT License - see the `LICENSE` file for details.
## 📧 Contact
Rawad Al Furas - [Your Email] - [Your Project Link]
Project Link: [https://github.com/RSTAD/Social-Media-Follower-Dashboard](https://github.com/RSTAD/Social-Media-Follower-Dashboard)