Getting started

Prerequisites

A macOS computer (macOS version 10.14 or newer recommended)

Installation

Visit this page and download the latest .dmg installer file. Double-click the downloaded file and follow the on-screen instructions to drag the Loco app into your Applications folder.

Hello World

We are going to use Next.js as an example, but you can use any server/framework that you have running.

npx create-next-app@latest
# cd into the app directory
npm run dev

(This typically starts your application on port 3000)

Add a Domain with Proxy in Loco

Open Loco App and click on the "Add Domain" button.

Domain Name: Enter a .local domain of your choice (e.g., my-app.local) and enable the proxy option. Click "Save"

Access Your App

Open your web browser and navigate to the .local domain you just added (e.g., https://my-app.local). You should now see your application!

Loco will handle generating and installing the necessary certificate to make your .local domain trusted.