PDS Home#

Very simple single-file PDS home page.

Why?#

By default, the PDS home page isn't very nice, especially on mobile. It's fine as a default, but we can do better.

The approach here is to make it into a single glorious HTML file to avoid overriding too many routes on the PDS, and make deployment as simple as possible.

There's still a build step involved because there's some dependencies involved (atcute), and working with types and CSS/JS in separate files is so much nicer.

How to use#

Before you deploy, you may want to fork this repository to customise the welcome message and/or PDS owner listed.

• Install dependencies with pnpm i

• Build the file with pnpm run build

• Upload the dist/index.html file to static hosting.

The most straighforward solution is to host it on the same server as your PDS.

You can simply add this directive to your Caddyfile:

@home path /
handle @home {
    root /<the directory where the file is>
    file_server
}

You will now see a pretty little home page for your PDS!