Custom Domains

Use .nodev domains for OAuth-friendly local development.

What Are .nodev Domains?

.nodev is a special top-level domain that works only on your local machine. Each project can have its own domain like:

• myshop.nodev

• dashboard.nodev

• api.nodev

.nodev domains work by modifying your local DNS resolver. They don't require internet access and only work on your Mac.

Why Use Custom Domains?

OAuth Callbacks

OAuth providers like Google and GitHub require registered redirect URLs. With .nodev domains, you can use stable URLs like http://myapp.nodev/auth/callback instead of http://localhost:3000/auth/callback.

CORS Solved

Both 127.0.0.1 and localhost point to your .nodev domain. This means consistent origins for APIs and no more CORS headaches.

Memorable URLs

No more remembering which port is which. Your projects have names, not random port numbers.

Production-Like

Local development feels more like production with proper domain names instead of localhost.

Setting Up Custom Domains

1. Open project settings by right-clicking the project
2. Enter a domain name (e.g., myapp)
3. Save the settings
4. Access your project at http://myapp.nodev

Domain names must be unique across all your projects. Nodev will warn you if you try to use a duplicate.

How It Works

Nodev configures your Mac to resolve .nodev domains locally:

• Domains resolve to 127.0.0.1
• Nodev routes requests to the correct project based on port
• Works with any browser or HTTP client
• No hosts file editing required

Future Features

Planned enhancements for .nodev domains:

• SSL/HTTPS support via local certificates

• Wildcard subdomains (*.nodev)

• Custom TLD support

• Integration with Caddy for advanced routing

These features are planned for future releases. Vote for your priorities on our roadmap.