PublicInbox::WWW(3)

💖 PublicInbox::WWW 💖

okay so bestie, we're looking at the manual page for PublicInbox::WWW(3) and honestly? it's giving "the web interface of your dreams". let's get into it 🫶

---

✨ NAME ✨

PublicInbox::WWW — the PSGI interface for public-inbox 💅

---

🌸 SYNOPSIS 🌸

so in your .psgi file, you do this:

use PublicInbox::WWW;

my $www = PublicInbox::WWW->new;
builder {
        enable 'Head';
        mount '/inboxes' => sub { $www->call(@_) };
};

that's it. that's the whole vibe. ✨

---

🦋 DESCRIPTION 🦋

it's the PSGI web interface for public-inbox, periodt.

ngl, you literally do not need to use this directly — like, not unless you're trying to customize your public-inbox PSGI deployment, or you're running a PSGI server that isn't public-inbox-netd(1) (aka -netd) or public-inbox-httpd(1) (aka -httpd). those two already have it handled. 💅

and while this PSGI application should work with all PSGI/Plack web servers — think starman(1), starlet(1), or twiggy(1) — the way that PublicInbox::WWW takes advantage of the internal APIs of -netd and -httpd to improve fairness when serving large responses for thread views, mbox downloads, and git clones?? lowkey iconic. it's not just any server, bestie, it's the server. 🔥

---

🎀 ENVIRONMENT 🎀

• PI_CONFIG — used to override the default ~/.public-inbox/config value. 🧚

---

💌 CONTACT 💌

feedback is welcome, and honestly we love to hear it — just send plain-text mail to <mailto:meta@public-inbox.org> 💖

the mail archives are hosted at <https://public-inbox.org/meta/> and over on the onion side at <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/> 🧅✨

---

👑 COPYRIGHT 👑

Copyright (C) all contributors <mailto:meta@public-inbox.org> 🌈

License: AGPL-3.0+ <http://www.gnu.org/licenses/agpl-3.0.txt> 💜

---

🌈 SEE ALSO 🌈

• <http://plackperl.org/> 🍓
• Plack
• public-inbox-netd(1)
• public-inbox-httpd(1)

---

ok and one last thing before you go — this whole thing came from perl v5.42.0, dated 2025-07-25, and yeah that's literally the entire manual. go forth and mount your inboxes, bestie, you ate 💅💖🦋