Documentation

Everything you need to know about this-is.app.

01

What are identity domains?

this-is.app lets you claim a personal subdomain like username.this-is.app. When someone visits it, they are instantly redirected to any URL you choose — your portfolio, GitHub profile, LinkedIn, or any personal website. It's your single, memorable identity link.

02

How wildcard DNS works

We use a wildcard DNS record (*.this-is.app) on Cloudflare that points all subdomains to our Vercel Edge infrastructure. This means any subdomain you claim is automatically routed to us, and we handle the redirect — no DNS configuration needed on your end.

03

How redirects work

Every redirect passes through two layers: 1. Edge Middleware — Upstash Redis cache is checked first. If cached, you're redirected in under 10ms. 2. API Fallback — If not cached, the database is queried, the result is cached, then you're redirected. This dual-layer approach ensures near-instant redirects at global scale.

04

How to claim a domain

1. Register or sign in at this-is.app. 2. Go to your Dashboard. 3. Click "New domain", enter your desired username and a redirect URL. 4. Click "Claim domain". Your domain is live immediately.

username.this-is.app → https://your-target.com
05

Username rules

• 3–30 characters long • Letters, numbers, and hyphens only • Cannot start or end with a hyphen • Cannot be a reserved system name (admin, api, docs, etc.) • No inappropriate or trademarked keywords

07

Analytics

Every redirect is tracked. In your Dashboard you can see: • Total click count per domain • Last access timestamp Extended analytics (country, device) can be enabled on request.

08

Rate limits

To prevent abuse, domain claims are limited to 5 per user per hour. Redirects themselves are unlimited.