MangaShelf

Public manga mode

Use GitHub as your manga backend

Readers do not upload anything. You upload image files into the repo, edit manifest.json, and the site automatically builds the library and chapter reader.

Folder pattern

content/
  duo-days/
    cover.jpg
    chapter-1/
      001.jpg
      002.jpg
      003.jpg
    chapter-2/
      001.jpg
      002.jpg

Keep page names numbered: 001, 002, 003. That makes your chapters easy to maintain.

manifest.json pattern

{
  "manga": [
    {
      "id": "duo-days",
      "title": "Duo Days",
      "cover": "content/duo-days/cover.jpg",
      "description": "A short series description.",
      "chapters": [
        {
          "id": "chapter-1",
          "title": "Chapter 1 - The Gift",
          "pages": [
            "content/duo-days/chapter-1/001.jpg",
            "content/duo-days/chapter-1/002.jpg"
          ]
        }
      ]
    }
  ]
}

Publishing checklist

  1. Make a GitHub repository.
  2. Upload these website files.
  3. Put manga images inside the content folder.
  4. Edit manifest.json whenever you add a manga, chapter, or page.
  5. Turn on GitHub Pages in repo settings.
Back to Library