Manhwa

Batteries-included long-strip comic reader for Phoenix — webtoons, manhwa, manhua, anything that reads by scrolling.

Mounts its own routes via a router macro, persists through a small Store behaviour, and ships the full reader UI on top of fresco_strip: pixel-space panel-snap (gutter detection), per-manga snap tuning, scroll speeds, auto-reader with optional OCR-adaptive delay, tap-zone presets, infinite next-chapter loading, progress persistence (page + fraction + reading time), a same-origin image proxy with per-source headers, and an optional annotation layer via etcher.

Reading paged comics? That's the sibling package — manga — a page/spread reader built on fresco's pan-zoom canvas (RTL/LTR, double-page spreads, page overrides).

Install

def deps do
  [
    {:manhwa, "~> 0.1"}
  ]
end

Wire it up

1. Routes — one macro call mounts the reader page and its whole API surface (chapter images, settings, progress, image proxy, marks, GIFs) under the same prefix:

# router.ex
import Manhwa.Router

scope "/" do
  pipe_through [:browser, :require_auth]
  manhwa_reader "/reader/manga"          # → /reader/manga/:source/:slug/:chapter
end

Options: series_segments: 1 | 2 (default 2 — a series is /:source/:slug; with 1 it's a single /:series slug).

2. Store — implement Manhwa.Store (the persistence contract: chapter lists, page URLs, per-series reader state, settings, progress, proxy authorization) and point config at it:

config :manhwa,
  store: MyApp.ReaderStore,
  current_user: {MyAppWeb.ReaderGlue, :current_user},   # (conn) -> user
  series_url: {MyAppWeb.ReaderGlue, :series_url}        # (series) -> details page path

3. JS — import fresco_strip's hooks in assets/js/app.js (plus etcher's if you use annotations):

import "../../deps/fresco_strip/priv/static/fresco_strip.js"

let liveSocket = new LiveSocket("/live", Socket, {
  hooks: { ...(window.FrescoHooks || {}), ...(window.EtcherHooks || {}) }
})

4. CSS — the templates use Tailwind + daisyUI classes (daisyUI v5 theme tokens). Add the package to your Tailwind v4 sources:

@source "../../deps/manhwa";

Optional adapters

Everything below lights up extra affordances; without them the reader renders fully, minus those buttons:

License

MIT