> For the complete documentation index, see [llms.txt](https://docs.flatredball.com/flatredball/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flatredball.com/flatredball/glue-reference/menu/file/glue-reference-file-new-project.md). # New Project ### Introduction The **New Project** menu item is used to show the new project window. **File->New Project** does the same thing as clicking the **Create New Project** quick action.

The New Project menu item is the same as the Create new Project quick action

Clicking either option shows the New Project window.

New Project Window

### Project Name Project Name sets the name of your project. This value sets: * Your .sln and .csproj file names * Your default namespace * The name of the built .exe file This should not have spaces, or any characters which would be invalid in a C# namespace. ### Platform The Platform dropdown determines which platform your project targets. Typically this should be one of the Desktop projects (either MonoGame or FNA). Additional platforms (such as mobile) can be added as synced projects. You can select one of the mobile or web projects if you are testing these platforms, or if you do not intend to ever target desktop. When the project is created, the Platform that you select determines the template that FlatRedBall downloads. Note that when you create a new project, the latest template (from the most recent monthly build) is downloaded. #### Select Local Project... If you would like to create a project from a local folder, you can select the **Select Local Project...** option.

Select Local Project dropdown option

This option is usually for advanced scenarios and contributors of FlatRedBall. You may want to select this option in the following situations: 1. If you are adding a new platform to FlatRedBall and are testing this new platform in the FlatRedBall Editor. 2. If you are making a modification to one of the existing templates which has not yet been built to a monthly release (such as upgrading to a new version of .NET) 3. If you have created a custom template for new projects which includes code or libraries common for your particular workflow If this option is selected, an open file dialog appears allowing you to select a folder which contains the root (.sln) of the desired starting template. Note that you can use this option to select any folder in the Templates folder if you have cloned FlatRedBall. As mentioned above, this is useful if you are making changes to template files and would like to test those in FlatRedBall.

Open file dialog selecting the FlatRedBallDesktopFnaTemplate folder

The folder that you have selected appers in the Platform dropdown.

Custom template location in the New Project window

### Use local copy if available This option controls whether to attempt to use a previously-downloaded .zip for the selected project rather than to download a new version. This option is useful if: 1. Your computer is offline so a download would fail 2. You are testing the creation of many projects and would like to speed up the process. This option skips the downloading of new projects which can be time consuming. By default this option is unchecked, so when the project is created a new .zip file is downloaded. You can view cached zip files at `%AppData%\GlueFormsCore` --- # 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.flatredball.com/flatredball/glue-reference/menu/file/glue-reference-file-new-project.md?ask=&goal= ``` `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.