LocalShip

Build and ship React/Electron apps with local LLMs, offline-first.

UI Preview

Basic Mode

Developer Mode

Settings

What It Does

• Uses local OpenAI-compatible endpoints (for example LM Studio) to generate and patch project files.
• Supports guided non-coder flow (Make / Change-Improve / Ask) and advanced mode.
• Runs a live preview with last-known-good fallback for safer iteration.
• Applies parser/repair logic for imperfect model outputs.
• Exports native desktop apps via Electron Builder (.dmg, .exe, .AppImage).

Tech Stack

• React 18 + TypeScript + Vite
• Tailwind CSS v3
• Electron

Prerequisites

• Node.js 18+ and npm
• LM Studio installed and running (or another OpenAI-compatible local server)
• At least one LLM loaded in memory in LM Studio
• LM Studio local server enabled (OpenAI-compatible endpoint)
• macOS/Windows/Linux (for target-specific native builds)

Installation

Clone and install:

git clone https://github.com/VibeCoderOSS/Localship.git
cd Localship
npm install

If vendor/setup assets were not prepared automatically, run:

npm run prepare

Open LM Studio and prepare the model runtime:

1. Load at least one model into memory.
2. Enable the local server (OpenAI-compatible API).
3. Confirm the endpoint is reachable (default: http://localhost:1234/v1/chat/completions).

Then launch the app:

npm run electron:dev

Development

Install dependencies:

npm install

Run web dev mode:

npm run dev

Run Electron + Vite dev mode:

npm run electron:dev

Build

Build web app:

npm run build

Build native app:

npm run dist

Artifacts are written to release/.

Tests

npm run test:parser
npm run test:prompt-composer
npm run test:stream-memory

Project Structure

• App.tsx - app shell and orchestration
• components/ - UI components (preview, settings, composer, modals)
• services/ - LLM integration, parsing, orchestration, model registry
• utils/ - project validation, export, prompt composition
• scripts/ - regression and setup scripts

Notes

• The app is designed for local/offline workflows.
• External runtime CDNs are intentionally avoided.
• This project is currently in beta.
• It has been specifically tested with mlx-community/Qwen3-Coder-Next-8bit.
• Support and behavior with other models have not been tested yet.

License

LocalShip is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
See LICENSE.

Third-party/runtime notices included in this repository:

• release/mac-arm64/LICENSE (Electron MIT license)
• release/mac-arm64/LICENSES.chromium.html (Chromium third-party licenses)

Brand