# Celo Composer

> Scaffold Celo dApps with Celo Composer. Use when starting new Celo projects, creating MiniPay apps, or setting up development environments.

- **Type:** Skill
- **Install:** `agentstack add skill-celo-org-agent-skills-celo-composer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [celo-org](https://agentstack.voostack.com/s/celo-org)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [celo-org](https://github.com/celo-org)
- **Source:** https://github.com/celo-org/agent-skills/tree/main/skills/celo-composer

## Install

```sh
agentstack add skill-celo-org-agent-skills-celo-composer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Celo Composer

This skill covers using Celo Composer to scaffold Celo dApps with pre-configured templates.

## When to Use

- Starting a new Celo project
- Creating a MiniPay Mini App
- Setting up a Farcaster Miniapp
- Need pre-configured Next.js + Web3 setup

## Quick Start

### Interactive Mode

```bash
npx @celo/celo-composer@latest create
```

Follow the prompts to select your options.

### With Project Name

```bash
npx @celo/celo-composer@latest create my-celo-app
```

### Non-Interactive (Flags)

```bash
npx @celo/celo-composer@latest create my-celo-app \
  --template basic \
  --wallet-provider rainbowkit \
  --contracts hardhat
```

### Quick Start with Defaults

```bash
npx @celo/celo-composer@latest create my-celo-app --yes
```

## Templates

| Template | Description | Use Case |
|----------|-------------|----------|
| `basic` | Standard Next.js 14+ dApp | General web3 applications |
| `minipay` | Mobile-first MiniPay app | MiniPay Mini Apps |
| `farcaster-miniapp` | Farcaster SDK + Frame | Farcaster integrations |
| `ai-chat` | Standalone chat application | AI-powered dApps |

### Create MiniPay App

```bash
npx @celo/celo-composer@latest create -t minipay
```

### Create Farcaster Miniapp

```bash
npx @celo/celo-composer@latest create -t farcaster-miniapp
```

## Configuration Options

### Wallet Providers

| Provider | Description |
|----------|-------------|
| `rainbowkit` | Popular wallet connection UI (default) |
| `thirdweb` | thirdweb Connect SDK |
| `none` | No wallet provider |

### Smart Contracts

| Option | Description |
|--------|-------------|
| `hardhat` | Hardhat development environment (default) |
| `foundry` | Foundry development environment |
| `none` | No smart contracts |

## Project Structure

```
my-celo-app/
├── apps/
│   ├── web/              # Next.js application
│   │   ├── app/          # App router pages
│   │   ├── components/   # React components
│   │   └── ...
│   └── contracts/        # Smart contracts (if selected)
│       ├── contracts/    # Solidity files
│       ├── scripts/      # Deployment scripts
│       └── test/         # Contract tests
├── packages/
│   ├── ui/               # Shared UI components
│   └── utils/            # Shared utilities
├── pnpm-workspace.yaml   # Workspace configuration
├── turbo.json            # Turborepo configuration
└── package.json
```

## Running the Project

```bash
cd my-celo-app

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build
```

## Tech Stack

- **Framework:** Next.js 14+ with App Router
- **Styling:** Tailwind CSS
- **Components:** shadcn/ui
- **Monorepo:** Turborepo + PNPM workspaces
- **Language:** TypeScript
- **Web3:** viem + wagmi (or thirdweb)

## Requirements

- Node.js 18.0.0 or higher
- PNPM (recommended) or npm/yarn

## Working with Contracts

If you selected Hardhat or Foundry:

### Hardhat

```bash
# Navigate to contracts
cd apps/contracts

# Compile
npx hardhat compile

# Test
npx hardhat test

# Deploy to Celo Sepolia
npx hardhat run scripts/deploy.ts --network celoSepolia
```

### Foundry

```bash
# Navigate to contracts
cd apps/contracts

# Build
forge build

# Test
forge test

# Deploy to Celo Sepolia
forge script script/Deploy.s.sol --rpc-url https://forno.celo-sepolia.celo-testnet.org --broadcast
```

## Environment Variables

Create `.env.local` in `apps/web/`:

```bash
# Required for wallet connection
NEXT_PUBLIC_WC_PROJECT_ID=your_walletconnect_project_id

# Optional: Alchemy API key
NEXT_PUBLIC_ALCHEMY_API_KEY=your_alchemy_key
```

Create `.env` in `apps/contracts/`:

```bash
PRIVATE_KEY=your_private_key
CELOSCAN_API_KEY=your_celoscan_api_key
```

## Customization

### Adding New Pages

Create files in `apps/web/app/`:

```tsx
// apps/web/app/my-page/page.tsx
export default function MyPage() {
  return My Custom Page;
}
```

### Adding Components

Add to `apps/web/components/` or shared `packages/ui/`:

```tsx
// apps/web/components/MyComponent.tsx
export function MyComponent() {
  return My Component;
}
```

## Additional Resources

- [templates.md](references/templates.md) - Detailed template documentation

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [celo-org](https://github.com/celo-org)
- **Source:** [celo-org/agent-skills](https://github.com/celo-org/agent-skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-celo-org-agent-skills-celo-composer
- Seller: https://agentstack.voostack.com/s/celo-org
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.