Examples you can clone and start.
Each one is a small app that shows a few devlanes features working. Its README walks through what happens when it starts.
$ git clone https://github.com/devlanes-run/examples $ cd examples/basics-hello-node $ devlanes start
Category
Built with
Teaches
Basics
Start here if devlanes is new to you.
Hello Node
Start here: one TypeScript server that gets its port and HTTPS hostname from devlanes.
run_scripthostsready.httptasks.when: lane.createglobal_env
Ready checks
Tell devlanes when each service is up, with an http, tcp, log or cmd ready check.
ready.httpready.tcpready.logready.cmdready.http.hosthosts.host_header- and 5 more
Languages
Services written in Python, Rust, Java and Go.
Python and FastAPI
Run a FastAPI app under uv behind the HTTPS proxy, and call other HTTPS services from it.
runrun_script (pyproject.toml)platform: pythontasks.when: lane.createSSL_CERT_FILEDEVLANES_ORIGINS
Rust and axum
Run the services of a Cargo workspace, with a ready timeout long enough for the first build.
run_script (Cargo.toml)ready.http.timeoutSSL_CERT_FILEdevlanes lane new
Java with Maven and Spring Boot
Run two Spring Boot apps from one Maven multi-module build, one calling the other over HTTPS with the devlanes CA trusted.
run_script (pom.xml)preset: spring-bootplatform: javahosts[].portready.http.timeoutservices.<name>.public_url
Go and net/http
Run two Go programs from one module, one with go run and one rebuilt by air, and call one from the other over HTTPS.
run_script (go.mod)run_script (Taskfile.yml)SSL_CERT_FILElane.data_pathready.http.timeoutdevlanes lane new
Web
Browser apps and the APIs they call, behind the HTTPS proxy.
Frontend and API on one lane domain
Point a React frontend at its lane's API, with CORS and a session cookie that work on the lane's domain.
preset: viteservices.<name>.public_urlservices.<name>.urlDEVLANES_ORIGINS
Next.js app with an HTTPS sibling API
Run Next.js with the next preset and call an HTTPS API in the same lane from a server component.
preset: nextNODE_EXTRA_CA_CERTSservices.<name>.public_urlservices.<name>.urltasks.when: lane.createdevlanes lane new- and 1 more
WebSockets and SSE
Serve WebSockets and server-sent events through the proxy, and give a service's second port its own hostname.
self.ports.<name>hosts[].portdevlanes debug freezedevlanes exec
Wildcard tenants
Serve every tenant on its own subdomain with a wildcard host, while exact hostnames and a fallback gateway take the rest.
hosts wildcardhosts.fallbackdomain()lanes.varstasks.when: lane.create
Fake SMS and email providers per lane
Swap SMS and email providers for local fakes, so each lane's messages land in its own inbox.
services.<name>.public_urltagsdevlanes stop
Frameworks
Dev servers that devlanes runs through a preset.
Cloudflare Workers
Run two Cloudflare Workers with the wrangler preset, joined by a service binding that resolves inside the lane.
preset: wranglerwrangler.varswrangler.argslane.data_pathlanes.hosts_filehosts[].port- and 1 more
Cloudflare Vite plugin per lane
Run a React app and a Worker in one Vite server, with an inspector port and stored state of its own in each lane.
preset: viteself.ports.<name>hosts.host_headerDEVLANES_LANE_DATA
Quarkus with Gradle and Postgres per lane
Run Quarkus dev mode from Gradle with its own Postgres container and debugger port in each lane.
run_script (build.gradle.kts)preset: quarkusself.ports.<name>infra.per_laneinfra.setupready.http.timeout
Infra
Databases and other containers, shared between lanes or one for each.
Shared Postgres with a database per lane
Share one Postgres container between lanes and give each lane its own database, migrated on every start.
infra.composeinfra.project_nameinfra.setupinfra.teardownlanes.varstasks.when- and 3 more
Postgres per lane
Give each lane its own Postgres container while Redis stays shared, and delete a lane's container together with its data.
infra.per_laneDEVLANES_COMPOSE_LANE_PROJECTinfra.setupinfra.teardownlanes.varsdevlanes lane clean- and 1 more
Many datastores with a namespace per lane
Share Postgres, Redis, ClickHouse, RabbitMQ and an S3 store across lanes, with a namespace in each one for every lane.
infra.setupinfra.teardowninfra.per_laneinfra.hostsinfra.hiddeninfra.project_name- and 1 more
Plain containers and external ports
Run containers without Compose, such as a mock OIDC provider for each lane, and route a hostname to a server you start yourself.
infra.containersinfra.hostsinfra.externaldevlanes.local.yamldevlanes exec
Workflows
How a team repository uses devlanes day to day.
Profiles and tags
Group the seven services of an npm workspace with tags and templates, and start a different set of them with each profile.
tagstemplatesextendsprofilesautostartkeep_awake- and 2 more
Queue workers per lane
Run two replicas of a worker that has no port and finishes the job in hand before it stops.
replicasreplica.indexready.logkeep_awakestop.signalpty- and 5 more
pnpm workspace with turbo and a second project
Run a pnpm and turbo monorepo with a service for each package, next to a second project in a subdirectory.
run_scripttemplatestagspreset: vitetasks.when: lane.createprojects.<name>.services- and 2 more
Dev servers and production builds from one folder
Switch a lane between dev servers and a production build with a profile, and keep personal settings in devlanes.local.yaml.
profilesrun_scriptsextendslane.data_pathautostartdevlanes --file- and 2 more
Dotenv and one domain root
Read values from a gitignored .env that every worktree shares, and build each URL from the lane's domain.
env.<NAME>global_envlane.domainproject.primary_pathdevlanes reload
From mprocs to devlanes
Move a project from mprocs, Caddy and a hand-made port script to devlanes, one piece at a time.
profilestagstaskstasks.afterhostsself.port- and 4 more
Run tests against a lane with devlanes with
Wrap a test run in devlanes with, which starts a lane, gives the tests its HTTPS URLs and stops it afterwards.
devlanes withDEVLANES_PUBLIC_URL_<SERVICE>profiles.run_scriptstasks.profilesdevlanes execdevlanes wait
Showcase
Larger stacks for trying the TUI and seeing failures.
A tour of the TUI
Walk through the TUI key by key, on the same stack as the demo on devlanes.run.
devlanesinfra.per_laneinfra.hostsinfra.setupinfra.teardownlanes.vars- and 6 more
Forty services and the start gate
Start 40 services at once and watch the start gate queue them, with CPU and memory shown for each one.
templatestagsready.logstartupdevlanes start --all-at-oncedevlanes debug top
Services built to fail
Break services on purpose and read what devlanes and the proxy's error pages say about each failure.
devlanes debug whydevlanes debug errorsdevlanes config checkready.httpready: startedtemplates- and 2 more
Remote
Lanes that run on another machine and open on yours.
Remote box in Docker
Run lanes on a box inside a Docker container and open them from your machine under the same hostnames.
remote.boxes.<name>.commanddevlanes daemon pairdevlanes remote connectdevlanes daemon revokehiddensync
Remote SSH box
Prepare a Linux server as a devlanes box and connect to it over SSH, Tailscale or Cloudflare Tunnel.
devlanes remote connectdevlanes daemon pairdevlanes remote lsports.range
No example matches.
Examples that are planned