Domain Management

Adding a New Domain

Step: Open Add Domain Modal

1. Navigate to the "Domains" page from the sidebar
2. Click the "Add Domain" button in the page header
3. The Add Domain modal will open

Step: Enter Domain Name

1. In the "Domain Name" field, enter your domain (e.g., example.com or subdomain.example.com)
2. Requirements:

- Must be a valid domain format

- Cannot start or end with a dot

- Cannot contain consecutive dots

- Maximum 253 characters

1. The field will validate as you type

Step: Configure Routes

1. In the "Routes" section, you'll see at least one route input (default: /go/*)
2. To add more routes:

- Click the "+ Add Route" button

- Enter the route path (e.g., /r/*, /link/*)

- Each route must be unique

1. To remove a route:

- Click the "Remove" button next to the route (only available when there are multiple routes)

1. Important: At least one route is required
2. Note: These routes must be configured in your Cloudflare Workers route settings

Step: Set Default Redirect Code

1. In the "Default Redirect Code" dropdown, select:

- 301 - Moved Permanently: Permanent redirect (best for SEO)

- 302 - Found (Temporary): Temporary redirect

- 307 - Temporary Redirect: Preserves request method

- 308 - Permanent Redirect: Preserves request method

1. This code will be used as the default for all links on this domain (can be overridden per link)

Step: Configure Dashboard Access (Optional)

1. Check the "Allow dashboard access via this domain" checkbox if you want users to access the dashboard using this domain
2. If unchecked, the dashboard will only be accessible via the default domain

Step: Create Domain

1. Review all settings
2. Click the "Create Domain" button
3. The modal will close and you'll see a success notification
4. The new domain will appear in your domains list

Step: Configure Cloudflare Routes

1. After creating the domain, you must configure the routes in Cloudflare Workers
2. Go to your Cloudflare dashboard
3. Navigate to Workers & Pages > Routes
4. Add routes matching the ones you configured (e.g., example.com/go/*)
5. Point them to your Worker

Editing a Domain

Step: Open Edit Modal

1. On the Domains page, find the domain you want to edit
2. Click the "Edit" button on the domain card
3. The Edit Domain modal will open (same as Add Domain)

Step: Modify Domain Settings

1. Domain Name: Can be changed (will affect all existing links)
2. Routes: Add, remove, or modify routes
3. Default Redirect Code: Change the default redirect code
4. Dashboard Access: Toggle dashboard access

Step: Save Changes

1. Click the "Update Domain" button
2. The modal will close and you'll see a success notification
3. The domain card will refresh with updated information

Activating/Deactivating a Domain

Step: Toggle Domain Status

1. On the Domains page, find the domain you want to activate/deactivate
2. Click the "Activate Domain" or "Deactivate Domain" button
3. A confirmation dialog will appear

Step: Confirm Action

1. Read the confirmation message:

- Deactivating: "Are you sure you want to deactivate this domain? Links will stop redirecting and new links cannot be created."

- Activating: "Are you sure you want to activate this domain? Domain will be re-enabled and links will start redirecting again."

1. Click "OK" to confirm or "Cancel" to abort

Step: Verify Status

1. The domain status will update immediately
2. Inactive domains show a warning box
3. Active domains function normally

Important Notes

1. Deactivated domains: Links will not redirect, new links cannot be created
2. Activated domains: All links work normally, new links can be created
3. Status changes take effect immediately