# 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:

1. **Open/select a Laravel project** (monolith or API with a Vue/React frontend in the same repo).
2. **Run a setup wizard** to choose:
   - PHP version
   - database
   - Redis
   - queue driver
   - how to serve frontend assets
3. **Connect your AI assistant** where one click configures MCP for Cursor and Claude Desktop, including project rules.
4. **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.

## Related AI Resources
- [SpinApp + built-in MCP for AI assistants](https://ai.spinapp.site/t/product-spinapp-mcp)
- [SpinApp provisions migrations-ready databases](https://ai.spinapp.site/t/product-migrations-ready-databases)
- [SpinApp queue dashboard (queue worker controls)](https://ai.spinapp.site/t/queue-dashboard)