How ruwantha-official/alpha works
Alpha is a Node.js web app exposing public scraping APIs alongside a small home and documentation site. The API workflow routes a request by plugin name, then each plugin fetches and parses a source site and returns JSON; F-Droid and Adaderana use the shared Axios request helper, while Cinesub uses Cloudscraper. The browser documentation page loads its endpoint examples from a static JSON file. Plugin implementations are shown, but the excerpts do not show the full set of endpoint documentation or all page-template behavior.
Main entry points: api.js API router · index.js Express server · req.js HTTP request helper · froid.js F-Droid scraper
Components 15
Web app
- Express server
index.js - Home page
app/pages/index.hbs - Docs page
app/pages/docs.hbs - Static assets
app/public
API routing
- API router
routers/api.js
Scraping plugins
- F-Droid scraper
routers/plugins/froid.js - Adaderana scraper
routers/plugins/deran.js - Cinesub scraper
routers/plugins/cinesubz.js - HTTP request helper
libs/req.js
Documentation client
- Docs loader
app/public/doc.js - Endpoint examples
app/public/doc.json
Other components
- Visitor
- F-Droid site
- Adaderana site
- Cinesub site
Connections 20
- Visitor → Express server: requests pages
index.js - Express server → Home page: renders home
index.js - Express server → Docs page: renders docs
index.js - Express server → API router: mounts API
index.js - Express server → Static assets: serves files
index.js - Visitor → API router: calls endpoint
routers/api.js - API router → F-Droid scraper: dispatches plugin
routers/api.js - API router → Adaderana scraper: dispatches plugin
routers/api.js - API router → Cinesub scraper: dispatches plugin
routers/api.js - F-Droid scraper → HTTP request helper: requests pages
routers/plugins/froid.js - Adaderana scraper → HTTP request helper: requests pages
routers/plugins/deran.js - HTTP request helper → F-Droid site: fetches
- HTTP request helper → Adaderana site: fetches
- Cinesub scraper → Cinesub site: scrapes pages
routers/plugins/cinesubz.js - F-Droid scraper → API router: returns JSON
routers/plugins/froid.js - Adaderana scraper → API router: returns JSON
routers/plugins/deran.js - Cinesub scraper → API router: returns JSON
routers/plugins/cinesubz.js - Visitor → Docs page: opens docs
- Docs loader → Endpoint examples: loads examples
app/public/doc.js - Express server → Docs loader: serves script
index.js