FIELD NOTES & GUIDES

Local HTTPS Without the Headache

Fix the terminal errors first. Understand why certificate trust, DNS, and WebSockets break. Then keep the fix.

• How to enable trusted HTTPS on localhost in Safari and Chrome on macOS

  Generate a local CA, sign leaf certificates with correct Subject Alternative Names, and import them into the macOS Login Keychain with CLI tools.

• mkcert Alternative with a Native macOS GUI

  Why mkcert is only half the battle: automating Keychain trust, reverse proxying port 443, wildcard DNS, and mobile device profiles.

• How to set up HTTPS in Vite local dev without certificate errors

  Fix Vite dev server HTTPS warnings and broken WebSocket Hot Module Replacement (HMR) across your frontend applications.

• How to fix untrusted SSL certificates on iOS Simulator and physical iPhone

  Install and enable full root certificate authority trust on iOS Simulators via simctl and on real iPhones via Apple .mobileconfig profiles.

• How to configure /etc/resolver for .test domains on macOS

  Route an entire development top-level domain (*.test) to localhost without editing /etc/hosts for every new project.

• Fix WebSocket and HMR connection failed behind HTTPS reverse proxy

  Diagnose and resolve WebSocket dropouts, 101 Switching Protocols failures, and Fast Refresh crashes behind TLS termination proxies.

• Next.js local HTTPS for Secure and SameSite cookies in development

  Eliminate OAuth redirect mismatch errors, WebAuthn failures, and dropped SameSite=None; Secure cookies during local Next.js development.