Skip to content

kyuuaria/aliasgen

Repository files navigation

Alias Gen

A minimal web app for generating unique email aliases on your own domain. Create a per-service alias in seconds, copy it, and register it with your email provider.

Inspired by SimpleLogin, but built for providers that let you create unlimited aliases on a custom domain - like Tuta, your own mail server, or any host that supports catch-all or unlimited alias creation.

How it works

The alias is generated as:

{service}.{suffix}@{domain}

The suffix depends on the selected mode:

  • Random characters - configurable length (3-12 chars), e.g. github.x9f2k@example.com
  • Random words - 1-3 words (adjective, or adjectives + noun), e.g. github.swift@example.com or github.bright-falcon@example.com

Configuration is saved to both the URL hash fragment and localStorage. On load, the hash takes priority - if empty (e.g. when opened as a PWA), localStorage is used. Either way, invalid or missing fields fall back to sensible defaults.

The hash fragment is base64-encoded and never sent to the server, so your config stays client-side.

Features

  • Two suffix modes with configurable length/word count
  • Debounced domain validation
  • Copy on click or Enter, auto-clears for the next alias
  • Lazy-loaded Three.js shader background
  • Installable PWA with persistent configuration

Stack

Getting started

pnpm install
pnpm dev

Build

pnpm build
pnpm preview

PWA install prompt only appears in preview or production - not in dev.