# Examples and Playground

The Umbraco CMS codebase comes with a set of customization examples and a way to run them using a local front-end server. This setup enables you to change the code and review the effects instantly by refreshing your browser.

[Browse the available examples in the Umbraco CMS Repository](https://github.com/umbraco/Umbraco-CMS/tree/main/src/Umbraco.Web.UI.Client/examples).

## Get Started

1. Clone the source code from <https://github.com/umbraco/Umbraco-CMS/>.
2. Make sure you have **npm** installed.
3. Open a terminal and navigate to `src/Umbraco.Web.UI.Client` .
4. Run the command: `npm install` .

### Run an Example

Start a local server and run one of the examples: `npm run example` .

### Create a playground

You can add a new example and use it as your playground. If it covers a specific topic that would be of interest to others, you can contribute it as a pull request.

To create a new example, follow these steps:

1. Create a new folder with a name of your choice in the `examples/` folder.
2. Add an `index.ts` file that exports an array of manifests as the default export (See the other examples if in doubt).
3. Run your example using the command listed above in [Run an example](#run-an-example).


---

# 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.umbraco.com/umbraco-cms/customizing/examples-and-playground.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.