hansputera/xbato-manhwa-manga-api

Project goals

Open

#1 opened on Aug 24, 2025

View on GitHub
 (0 comments) (0 reactions) (1 assignee)TypeScript (0 forks)auto 404
documentationenhancementgood first issuequestion

Repository metrics

Stars
 (1 star)
PR merge metrics
 (No merged PRs in 30d)

Description

Main Goals

  • Separate the API service from the library (sometimes APIs can become complex with features like caching, database saving, etc. So it's better to keep them separate).
  • Since I'm from Indonesia and xbato.com is blocked by Kominfo (Kementerian Komunikasi dan Informatika) in Indonesia, we should use an external DNS service to access xbato.com (see the first attachment below).
  • Implement search endpoints for manga/manhwa and retrieve manga/manhwa chapters.

Next Goals

  • Merge all media/photos in a chapter into a single PDF document and upload it to S3 (Cloudflare R2 can be used as a free option).
  • Cache or store xbato.com manga/manhwa objects in a database (we can use Cloudflare D1 or PostgreSQL if you have your own server) to reduce the number of requests sent to xbato.com.
  • (Optional) Implement a webhook notification system for new manga/manhwa chapters (this is a special feature, so it could be developed in a separate project or repository).

Footnotes

  1. The Xbato.com API Wrapper repository is available on my Codeberg https://codeberg.org/hansputera/xbato-api-wrapper

Attachments

Contributor guide

Research direction
Familiarize yourself with the existing xbato api wrapper library and the current project structure. Then, pick one specific goal (e.g., implement search endpoints) and plan the implementation steps. Consider how to separate the API service from the library.
Tech stack
typescript
Domain
backendapi
Issue type
Research
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
4
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Over 1 week
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Needs investigation
Prerequisites
TypeScriptNode.jsHTTPREST API
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
30