← Projects

● Active

surfy

Give every local app a stable, trusted HTTPS address. Run your frontend and backend together at a memorable .localhost URL.

View source
Works with
Apple Silicon Macs
Status
Active

The problem

Local development means port hunting, certificate warnings and a separate process manager for every project.

What it does

Surfy runs your frontend and backend together at a memorable .localhost URL, with no port hunting and no certificate warnings.

https://my-project.localhost          → frontend
https://my-project.localhost/api/*    → backend, path preserved

Get started

Surfy currently supports Apple Silicon Macs (M1 or newer) and installs through Homebrew.

brew tap tankibaj/surfy https://github.com/tankibaj/surfy
brew install tankibaj/surfy/surfy

# set up trusted local HTTPS once
surfy install

# in your project
surfy init
surfy start

A project can also declare its apps in a surfy.yaml manifest:

web: ./frontend
api: ./backend