> For the complete documentation index, see [llms.txt](https://docs.jigx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jigx.com/building-apps-with-jigx/jigx-builder-code-editor/create-a-new-jigx-solution.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.jigx.com/building-apps-with-jigx/jigx-builder-code-editor/create-a-new-jigx-solution.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.