<div align="center">
  <img src="plugins/appmarquee/assets/icon.svg" width="84" alt="AppMarquee logo" />
  <h1>AppMarquee</h1>
  <p><strong>Your store-screenshot studio—built for people and agents.</strong></p>
  <p>Create, review, localize, and export App Store and Google Play screenshot decks from one local workspace. Give agents the screenshots, not your source code.</p>

  [![CI](https://github.com/furkangonel/AppMarquee/actions/workflows/ci.yml/badge.svg)](https://github.com/furkangonel/AppMarquee/actions/workflows/ci.yml)
  [![License: MIT](https://img.shields.io/badge/license-MIT-7EA2FF.svg)](LICENSE)
  [![MCP](https://img.shields.io/badge/MCP-10_tools-F56F5D.svg)](plugins/appmarquee/mcp/server.ts)
  [![Local first](https://img.shields.io/badge/data-local--first-77E7B8.svg)](docs/ARCHITECTURE.md)

  **English** · [Türkçe](README.tr.md)
</div>

![AppMarquee project workspace](docs/assets/appmarquee-hero.jpg)

## The short version

Most screenshot generators begin as code inside each app repository. AppMarquee is one reusable program instead:

1. Create a project in AppMarquee.
2. Upload real product screenshots.
3. Ask Codex, Claude, or another MCP agent to build the story.
4. Review visually and export every required store size.

The agent never needs the app’s source directory. Your project files and screenshots remain local.

## What ships

| Studio | Agent bridge | Output |
| --- | --- | --- |
| Multi-project dashboard + bulk import | Codex plugin + MCP server | App Store iPhone and iPad sets |
| Connected or isolated canvas | Claude Code and generic MCP setup | Google Play phone and tablet sets |
| Drag, resize, rotate, reorder | Visual screenshot reading | 1024×500 feature graphics |
| Themes and localized copy | Revision-safe targeted updates | Language-selectable PNG ZIP bundles |

![AppMarquee connected-canvas editor](docs/assets/appmarquee-editor.jpg)

## Quick start

Requires [Bun](https://bun.sh/) 1.1+ and Node.js 20+.

```bash
git clone https://github.com/furkangonel/AppMarquee.git
cd AppMarquee
bun install
bun run mcp:build
bun run dev
```

Open [http://127.0.0.1:3000](http://127.0.0.1:3000).

### Connect Codex

```bash
bun run mcp:install:codex
```

### Connect Claude Code

```bash
bun run mcp:install:claude
```

### Connect Claude Desktop

```bash
bun run mcp:install:claude-desktop
```

Completely quit and reopen Claude Desktop after installation. See the **[complete Claude Desktop guide](docs/CLAUDE_DESKTOP.md)** for manual configuration, verification, removal, troubleshooting, and Desktop Extension status.

Restart the agent, then ask:

```text
Check AppMarquee status. Inspect the screenshots in Focus Garden and create
a six-screen iPhone deck in English and Turkish. Validate it when finished.
```

That is enough. You can launch the agent from another folder; the generated MCP configuration uses an absolute path.

For plugin marketplace installation, generic MCP JSON, verification, and removal instructions, see the **[complete installation guide](docs/INSTALLATION.md)**.

## Designed for a real launch workflow

### 01 — Bring the product proof

Select or drop several simulator, emulator, or device captures in one pass. AppMarquee sorts them by filename, fills empty screens, and adds screens up to the active store limit. Assets use content-addressed filenames and stay inside that local project.

### 02 — Let the agent shape the narrative

The agent can view uploaded screenshots, write benefit-led copy, choose layouts, localize text, and replace only the requested device deck. Revision checks prevent stale agent writes from silently replacing newer human edits.

### 03 — Keep the final visual decision human

Reload agent changes in the editor, adjust anything visually, choose exactly which project languages to download, and export exact PNG bundles. AppMarquee supports iPhone, iPad, Android phone, 7-inch tablet, 10-inch tablet, and Google Play feature graphics.

## MCP tool surface

| Tool | What it lets an agent do |
| --- | --- |
| `appmarquee_status` | Confirm that the local studio is available |
| `appmarquee_list_projects` | Discover local projects without a directory path |
| `appmarquee_create_project` | Start a new launch workspace |
| `appmarquee_get_project` | Read project state and its current revision |
| `appmarquee_list_assets` | Find uploaded product screenshots |
| `appmarquee_read_asset` | View an uploaded screenshot as image content |
| `appmarquee_update_device_deck` | Replace one device deck without touching the others |
| `appmarquee_update_settings` | Change name, theme, canvas mode, or locales |
| `appmarquee_validate_project` | Check structure and Apple/Google screen limits |
| `appmarquee_project_link` | Return the exact local visual-review URL |

## Why it stays light

AppMarquee avoids keeping every full-resolution screen alive at once. The editor renders detail only around the active slide, uses schematic sidebar thumbnails, keeps a decode-only image cache, captures each export source once, and streams uncompressed PNGs into the ZIP. See [Architecture](docs/ARCHITECTURE.md).

## Project storage

```text
projects/
└── focus-garden/
    ├── project.json
    └── assets/
        ├── 2b7d56c89bfa62e1.png
        └── a8b701c50136ee9d.jpg
```

`projects/` is ignored by git by default. Publishing this repository does not publish local screenshot projects.

## Development

```bash
bun run check          # unit tests + MCP bundle + production application build
bun run mcp:test       # real stdio client smoke test (studio must be running)
bun run project:list
bun run appmarquee validate <project-id>
```

Useful references:

- [Agent workflow](docs/AGENT_WORKFLOW.md)
- [Installation for Codex, Claude, and other clients](docs/INSTALLATION.md)
- [Claude Desktop setup](docs/CLAUDE_DESKTOP.md)
- [Architecture and security boundaries](docs/ARCHITECTURE.md)
- [Contributing](CONTRIBUTING.md)

## Open-source lineage

AppMarquee is an independent open-source continuation of Parth Jadhav’s original `app-store-screenshots` project. The editor foundation remains MIT-licensed; AppMarquee adds a multi-project workspace, local project API, lower-memory rendering, revision-safe MCP tools, plugin packaging, and the new product identity.

## License

[MIT](LICENSE) © AppMarquee contributors.