This is a free and open-source redirect static site hosted on GitHub Pages. It is incredibly easy to edit and use for your own custom short links and domain routing.
This project uses a clever GitHub Pages trick: index.html and 404.html are identical files. This is because GitHub Pages looks for a file matching your URL path, and if it fails to find it, it defaults to loading 404.html. We use this behaviour to catch all incoming parameters and paths.
For example, if this project is hosted on fnswe.me, it automatically points to a fallback domain like fonseware.com after a brief loading animation.
It supports two types of URL routing:
- Parameter Routing:
fnswe.me?u=status> points to >status.fonseware.com - Path Routing:
fnswe.me/status> points to >status.fonseware.com
To get your own redirector up and running, follow these steps:
- Fork this project to your own GitHub account.
- Edit
index.html:- Open the file and scroll down to the script section. Search for
const fallbackURL = "https://fonseware.com";and change it to your own main website. - Update the
faviconlink in the<head>and the logo<img>source in the<body>to match your own branding. - Note: You only need to edit
index.html! This project includes an automated GitHub Action that will copy your changes to404.htmlfor you.
- Open the file and scroll down to the script section. Search for
- Edit
redirects.json: Add your custom paths and destinations here. The file needs to be formatted as a JSON array like this:
[
{
"id": "status",
"url": "[https://status.fonseware.com](https://status.fonseware.com)"
},
{
"id": "github",
"url": "[https://github.com/yourusername](https://github.com/yourusername)"
}
]
To make life easy, this project already comes with a GitHub Actions workflow attached. Whenever you push changes to index.html, this action automatically copies those changes over to 404.html so you do not have to do it manually.
By default, the script includes a 6-second (6000ms) delay to display a skeleton loading animation while the external assets load and the redirect processes. You can adjust this timeout in the <script> tag if you want a faster, instant redirect.
This project is licensed under the MIT License. You are totally free to fork, edit, and use this for your own projects. Attribution to the original creator is highly appreciated, but not mandatory.