Documentation

Everything you need to know about getting and managing your free .rushvx.dev subdomain.

Method 1: Dashboard (Recommended)

  1. 1. Go to rushvx.dev/login and sign in with your Google account.
  2. 2. From the dashboard, click Register Subdomain.
  3. 3. Enter your desired subdomain name, select a DNS record type, and provide the target value.
  4. 4. Click Register. DNS propagation happens automatically within minutes.

Method 2: Pull Request (Classic)

  1. 1. Fork the repository on GitHub.
  2. 2. Create a JSON file in the domains/ folder named yourname.json.
  3. 3. Add this content:
{
  "owner": {
    "github": "your-github-username"
  },
  "record": {
    "CNAME": "your-target.example.com"
  }
}
  1. 4. Open a Pull Request to the main branch.
  2. 5. The PR will be automatically validated and merged if all checks pass.

Supported DNS Record Types

A Record

Points your subdomain to an IPv4 address.

{ "record": { "A": "192.168.1.1" } }

AAAA Record

Points your subdomain to an IPv6 address.

{ "record": { "AAAA": "2001:db8::1" } }

CNAME Record

Points your subdomain to another domain. Most common.

{ "record": { "CNAME": "myapp.vercel.app" } }

TXT Record

Text records for verification, SPF, etc.

{ "record": { "TXT": "v=spf1 include:..." } }

Rules

  • Subdomain names can only contain lowercase letters, numbers, and hyphens.
  • Names cannot start or end with a hyphen.
  • Maximum length: 63 characters.
  • Some names are reserved (admin, api, mail, etc.) and cannot be registered.
  • One DNS record per subdomain.
  • Do not use subdomains for illegal or abusive purposes.