---
title: 'Development setup'
icon: 'circle-2'
---

## Prerequisites

- Node.js v22.15+ or v24
- npm v9+

## Instructions

1. Setup the environment

```bash
node tools/setup-dev.js
```

2. Start the environment

This command will start activepieces with PGLite and an in-memory queue.

```bash
npm start
```

<Note>
  By default, the development setup only builds specific pieces.Open the file
  `.env.dev` and add comma-separated list of pieces to make
  available.

For more details, check out the [Piece Development](/build-pieces/building-pieces/development-setup#pieces-development) section.

</Note>

3. Go to **_localhost:4200_** on your web browser and sign in with these details:

Email: `dev@ap.com`
Password: `12345678`


## Pieces Development

When [`AP_PIECES_SYNC_MODE`](https://github.com/activepieces/activepieces/blob/main/.env.dev#L14) is set to `OFFICIAL_AUTO`, all pieces are automatically loaded from the cloud API and synced to the database on first launch. This process may take a few seconds to several minutes depending on your internet connection.

For local development, pieces are loaded from your local `dist` folder instead of the database. To enable this, set the [`AP_DEV_PIECES`](https://github.com/activepieces/activepieces/blob/main/.env.dev#L5) environment variable with a comma-separated list of pieces. For example, to develop with `google-sheets` and `cal-com`:

```sh
AP_DEV_PIECES=google-sheets,cal-com npm start
```