Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dev Browser

License: MIT Platform: macOS Shell: Bash Version: 2.1.0

A development tool that creates custom browser shortcuts with DNS override rules, allowing developers to redirect specific hostnames to different IP addresses for local development and testing.

📖 View Full Documentation & Examples →

Quick Start

One-Command Install

curl -fsSL https://raw.githubusercontent.com/cjflory/dev-browser/main/dev-browser | bash -s install

Create Your First Dev Browser

dev-browser create

Follow the interactive prompts to set up DNS rules like:

  • example.com192.168.1.100 (your local dev server)
  • api.example.com192.168.1.101 (your local API)

What This Does

  • Creates native macOS apps that launch browsers with custom DNS rules
  • Uses separate browser profiles isolated from your main browser
  • Works with Chromium browsers: Chrome, Brave, Edge, Vivaldi, Opera, Arc
  • No admin privileges required - no system-wide changes
  • Perfect for local development where you need production domain names

Key Commands

dev-browser create          # Create a new browser app
dev-browser list            # List all created apps  
dev-browser remove <id>     # Remove an app
dev-browser uninstall       # Remove dev-browser entirely

Requirements

  • macOS (10.14+)
  • At least one Chromium-based browser
  • Bash (pre-installed)

Example Use Cases

  • Test your React app against different API environments
  • Run microservices locally with production-like URLs
  • Create isolated browser profiles for different projects
  • Debug authentication flows with real domain names

Need more details? Check out the full documentation with examples, troubleshooting, and advanced features.

About

A development tool that creates custom browser shortcuts with DNS override rules, allowing developers to redirect specific hostnames to different IP addresses for local development and testing.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages