# How to Scaffold an App

## Background

See this page for what Scaffold is:

{% content-ref url="/pages/hvGjzhgu6l2Nw4iB48E6" %}
[Scaffold](/core-concepts/scaffold.md)
{% endcontent-ref %}

## Prerequisites

{% hint style="info" %}
We currently only support Docker for containerization
{% endhint %}

1. Install Docker <https://docs.docker.com/engine/install/>
2. After installation ensure that `docker compose` is a valid command

## Steps to Scaffold an App

1. Run the scaffold app create command in the root of your app directory.

```bash
stoobly-agent scaffold app create <APP-NAME>
```

{% hint style="info" %}
**Recommended for E2E Testing:** Include `--plugin playwright` or `--plugin cypress` when creating the app scaffold. This sets up Playwright or Cypress-specific configurations and dependencies for running E2E tests.
{% endhint %}

{% hint style="info" %}
We recommend running this command from the root directory of a version-controlled code repository.
{% endhint %}

2. A `.stoobly` [context](/core-concepts/context.md) will be created in the app directory if it does not already exist
   1. Inside the context folder, a `docker` folder will be created with initial core services


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stoobly.com/guides/how-to-integrate-e2e-testing/how-to-scaffold-an-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
