# Lazer Mini Apps

Building mini apps for Farcaster and Base with an agent-native workflow.

## Quick Start

```bash
# Scaffold a new app
bunx @lazer-tech/miniapp create my-app

# Navigate and run
cd my-app
bun dev
```

## Agent Integration

Agents should register the Lazer CLI globally to discover and call all commands:

```bash
# Register as MCP server
bunx @lazer-tech/miniapp mcp add

# Sync skill files to agents (Claude, Cursor, etc.)
bunx @lazer-tech/miniapp skills add
```

## Core CLI Commands

- `miniapp create [name]`: Scaffold a new mini app. Supports `--platform` (web, farcaster, base), `--chain` (evm), and `--feature` (auth, contracts, codex, postgres).
- `miniapp update`: Add platforms, chains, or features to an existing project.
- `miniapp theme`: Regenerate CSS tokens from `branding.json` or a primary color.

## Project Skills

Scaffolded projects include agent-readable source references. Use these slash-commands within a project to implement features:

- `/auth`: Privy authentication (wallet, email, social login).
- `/web3`: EVM wallet support (wagmi/viem) and token swaps.
- `/farcaster`: Farcaster SDK, manifest, and notifications.
- `/base`: Base platform adapter and deeplinks.
- `/codex`: Real-time blockchain data (prices, charts).
- `/postgres`: PostgreSQL with type-safe Kysely queries.
- `/contracts`: EVM smart contracts via Foundry.
- `/ds`: Design system components and theme customization.
- `/lazer`: Main entry point to chain multiple skill requests.

## How it Works

Lazer scaffolds a minimal Next.js app and provides agents with the references needed to build only requested features. Agents use project-level skills to surgically write logic directly into the source code.