Link Front Page
April 26, 2026 · View on GitHub
A personal landing page for your YOURLS install — Linktree-style links, an image grid, an About-me block, and a full design panel. All from one settings screen, no theme files to edit.
🌐 Live demo: https://toine.click
What you can do with it
🔗 A Linktree-style link list
Add as many links as you want, group them into category boxes, drag them around to reorder. Each entry has its own image, title, description, and a click-through that either points at a YOURLS shortlink (so click stats keep working) or any URL you type in.
🖼️ An image grid
Three-column gallery for "link in bio" content — Instagram-style. Bulk-upload a folder of images, give each tile a title overlay (always shown / on hover / hidden), and have it click through to a URL or a YOURLS shortlink.
👋 An About-me block
Profile photo, short bio, and a row of icon-only buttons for 37 social platforms (X, Instagram, GitHub, Mastodon, Bluesky, Threads, Patreon, Ko-fi, …). You can also surface a Personal and a Business contact card with one-click vCard download for visitors.
🎨 A full design panel
Pick colours, fonts, background images and spacings until it looks right. Typography supports a system stack, 85+ Google Fonts (with live preview), or your own font upload. Spacings accept any CSS unit (px, em, rem, clamp(), calc(), …). There's a Custom CSS escape hatch for anything the panel doesn't cover.
➕ Quick-add from the link table
Every row of YOURLS' admin link table grows a small + button next to Stats / Share / Edit / Delete. One click adds that shortlink to the bottom of your homepage list, with the destination's favicon as the default image.
🚦 A friendlier 404 page
Decide what happens when someone visits a shortlink that doesn't exist: keep YOURLS' default redirect, send them to your landing page, redirect to any URL or shortlink, or render a styled error page with your own message + button.
Installation
- Download
YOURLS-Link-Front-Page-vX.Y.Z.zipfrom the Releases page and unzip into youruser/plugins/folder. The final path should beuser/plugins/Link-Front-Page/. - Open the YOURLS admin → Manage Plugins → click Activate on Link Front Page.
- A new sub-page appears under Manage Plugins → Link Front Page. Open it and start adding things.
…or via git:
cd /path/to/yourls/user/plugins
git clone https://github.com/toineenzo/YOURLS-Link-Front-Page.git Link-Front-Page
Heads-up: if your YOURLS root is missing
index.php(e.g. you replaced it with a custom homepage), Apache returns 404 for/. Restore the standard YOURLSindex.phpand the plugin will pick it up.
A short tour
The settings page has four tabs:
| Tab | What you do here |
|---|---|
| Links | Build the link list and category boxes shown on /. |
| Image grid | Manage the image gallery (bulk-upload, per-tile dialog, "Show more"). |
| General | Site title, About-me, social buttons, contact cards, footer, 404 behaviour. |
| Appearance | Colours, background image, spacing, typography, custom CSS. |
Hit Save settings and visit / to see your changes live.
Compatibility
- YOURLS 1.9 or newer (verified against 1.10).
- PHP 8.1 or newer (8.4 recommended).
- Plays nicely with the Sleeky admin theme — the CI suite tests both setups on every release.
Help & feedback
Found a bug or have an idea? Open an issue. Please mention your YOURLS and PHP version.
License
MIT. Bundles Parsedown (MIT) for Markdown and simple-icons (CC0) SVGs.