Skip to content

ulascanaydin/Local-Dev-Launcher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Local-Dev-Launcher

Run your AI-built apps like real applications. No terminal. No commands. Just click play.

Local-Dev-Launcher screenshot

The Problem

You built an app with AI. It works. It lives in a folder on your desktop. But every time you want to use it, you open a terminal, cd into the folder, remember the right command, and wait. If you built five apps, that's five terminals. You shouldn't need a developer workflow to open something you made.

What This Does

Local-Dev-Launcher turns your project folders into launchable apps. Drop a folder in, and the app figures out the rest — what framework it uses, what command starts it, what port it runs on. Hit play. Your app opens in the browser.

  • Drop a folder in — drag it onto the app or browse to it
  • Auto-detect everything — framework, start command, port, Node version. No configuration needed.
  • Click play — your app starts and opens in the browser automatically
  • Click stop — clean shutdown, no orphan processes
  • See what's happening — live logs if you want them, error messages that actually tell you what went wrong

Who This Is For

You used ChatGPT, Claude, Cursor, or another AI tool to build a web app. It runs locally. You want to open it the way you open any other app on your Mac — not by typing commands into a terminal.

Features

Auto-Detection Recognizes your framework, picks the right start command, finds the right port
One-Click Launch Start any project and auto-open it in your browser
Live Logs See what your app is doing in real time — stdout, stderr, status
Error Help When something breaks, the app tells you what went wrong and suggests a fix
Folder Groups Organize your projects into collapsible folders
Menu Bar See what's running at a glance without opening the full app
Drag and Drop Drop a project folder onto the sidebar to add it
Accessibility Full VoiceOver support, respects system accessibility settings

Supported Frameworks

Currently detects Node.js projects:

Framework Port
Next.js 3000
React 3000
Vue.js 5173
Angular 4200
Express 3000
Svelte 5173
Nuxt.js 3000

Also detects your Node version from .nvmrc or .node-version and sets it up automatically.

Python projects (flask, fastapi, django, uvicorn) are also detected automatically.

More stacks coming (Ruby, Go).

Install

Download the latest DMG from the Releases page, open it, and drag Local-Dev-Launcher to your Applications folder.

Requirements

  • macOS 15.6 (Sequoia) or later
  • Node.js installed (for running your projects)

Build from Source

git clone https://github.com/ulascanaydin/Local-Dev-Launcher.git
cd Local-Dev-Launcher
xcodebuild -project Local-Dev-Launcher.xcodeproj -scheme Local-Dev-Launcher -configuration Release build

No external dependencies. Pure Swift and SwiftUI.

How It Works

  1. You add a project folder
  2. The app reads package.json, detects the framework and start command
  3. You click play
  4. The app runs the start command, monitors the process, and opens your browser to the right URL
  5. You click stop when you're done

That's it. No terminal. No configuration files. No remembering commands.

License

MIT

About

One-click launcher for local dev servers. Detects Node.js and Python projects, starts them, opens the browser.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors