Skip to content

remember2hydrate/bingepal

Repository files navigation

BingePal

BingePal is an open-source platform for exploring Movies, Series, Anime, Books, Manga, and Games.

It includes:

  • Android search app
  • FastAPI backend for content search & tracking
  • Web dashboard using HTML, Bootstrap & Chart.js

All parts connect via a shared REST API β€” no accounts, no ads, just a full-stack demo.

Project Focus

This project was designed as a backend-first demo of system structure and deployment practices.

UI/UX and styling choices were kept intentionally minimal to highlight API architecture and backend engineering.

πŸ› οΈ Features

  • REST API with FastAPI
  • Swagger UI docs
  • Android + Web client
  • Token-based admin log console
  • Docker + CI/CD automation

πŸ”— Live API + Docs

Live Backend API: https://bingepal.onrender.com
Docs: https://bingepal.onrender.com/docs

🐳 Docker Support

To build and run the FastAPI backend with Docker:

docker build -t bingepal-backend .
docker run --env-file .env -p 8000:8000 bingepal-backend

βš™οΈ CI/CD Workflows

Includes GitHub Actions for:

  • Android build + lint
  • Backend testing
  • Web dashboard deployment
  • Auto-syncing subfolder repos

These workflows ensure continuous integration and consistent deployment across all components.

πŸ“ See architecture.md for a technical breakdown.

Note: Documentation was drafted and refined with AI assistance for clarity and structure.

About

An open-source demo platform for exploring Movies, Series, Anime, Books, Manga and Games.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published