Getting started with SpinApp (download, setup, run containers)

Download SpinApp for macOS, run the setup wizard, configure AI via MCP, and start containers.

Overview

SpinApp is a Laravel local dev app that gets your project running in Docker without hand-written docker-compose.yml. This guide covers download, setup, AI configuration via MCP, and starting the local environment.

System requirements (macOS)

SpinApp lists these requirements:

Requires macOS 12+
Docker Desktop or Colima
Supports Apple Silicon and Intel

Download

SpinApp provides a download CTA for macOS v0.1.11. SpinApp also lists “Windows version [is] coming soon.”

Getting started flow (4 steps)

SpinApp a four-step workflow:

Open/select a Laravel project (monolith or API with a Vue/React frontend in the same repo).
Run a setup wizard to choose:
- PHP version
- database
- Redis
- queue driver
- how to serve frontend assets
Connect your AI assistant where one click configures MCP for Cursor and Claude Desktop, including project rules.
Start containers, then access the app at my-app.local with npm run dev ready.

Setup wizard configuration items

SpinApp’s setup wizard includes options for:

PHP version
database selection
Redis
queue driver
frontend asset serving method

AI assistant configuration with “Setup AI” (MCP)

SpinApp integrates with AI assistants through MCP. SpinApp supports connecting Cursor and Claude Desktop (or any MCP client) and then using “Setup AI” to write project rules and provide the assistant correct container context.

After containers start: local URLs and frontend dev

SpinApp manages /etc/hosts so the app lives at my-app.local. SpinApp also runs npm run dev so frontend development is ready after containers start.