# Create a new Jigx Solution

Creating a Jigx App starts with building a solution in Jigx Builder, then [publishing](/building-apps-with-jigx/jigx-builder-code-editor/publishing-a-solution.md) the solution to Jigx Cloud.

### Solution requirements

Every Jigx solution requires the following:

* **Solution title** - the solution title is visible at the top of the [home hub](/building-apps-with-jigx/ui/home-hub.md) screen in the app. Ensure that the title is unique, as there is no validation on the name, which could result in overwriting an existing solution with the same title.
* **Solution name** - The solution name is the system name and Jigx derives the name from the solution title with the following rules applied:
  * Cannot start with a number
  * No spaces are allowed; hyphens replace spaces
  * It must be in lowercase
* **Solution category** - Provides a list of predefined categories to choose from. The category you select displays as a tag at the top of your solution in the [Home Hub](/building-apps-with-jigx/ui/home-hub.md) under the solution title in the app.
* **Solution location** - either on your local machine or in a Git repository.
* **Index.jigx** - The index.jigx file is the home screen for the app. Add tabs to determine the layout. See [Home Hub](/building-apps-with-jigx/ui/home-hub.md) and [Index settings](/building-apps-with-jigx/ui/home-hub/index-settings.md) for more information.

{% embed url="<https://vimeo.com/829859076?share=copy>" %}

### Steps

1. Open VS Code, and click on the Jigx Builder **icon** in the left navigation bar. Select the **Create New Jigx Solution** button.
2. Provide a **solution title** and press enter.
3. The **Solution name** field pre-populates with the solution's system name. You can provide a different solution name if you want.
4. Select a relevant **category** where you want the solution saved.
5. Select a local folder or Git repository where the project files are saved too.
6. Your Jigx [solution scaffolding](/building-apps-with-jigx/jigx-builder-code-editor/editor.md) opens in the VS Code editor with the .jigx extensions ready for editing.

Follow the steps in the getting started section to [build your first Jigx solution](/getting-started/create-an-app-from-scratch.md).


---

# 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.jigx.com/building-apps-with-jigx/jigx-builder-code-editor/create-a-new-jigx-solution.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.