# Quick Start Guide

### Introduction

If you're looking to get started without going through lengthy tutorials, this guide will get you running with the minimum number of steps.

Note that this guide assumes you are using the FlatRedBall Editor. If you are creating a code-only project, see the [Code Only Projects](https://docs.flatredball.com/flatredball/tutorials/code-only-project-tutorial) page.

### Downloading FlatRedBall

First you will need to make sure you have the prerequisites. Once you do, you need to download FlatRedBall. For detailed steps, see the [Downloading FlatRedBall](https://docs.flatredball.com/flatredball/readme) page.

### Creating a New Project

To create a new project:

1. Click the Create New Project button

   <figure><img src="https://951240982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_fye9Ufg3vzJxwX5Hk%2Fuploads%2Fgit-blob-ff739c88cb206e27638a5d5c531ef4e0ed8da119%2Fimage.png?alt=media" alt=""><figcaption><p>Create New Project button</p></figcaption></figure>
2. Leave the defaults and click the **Create Project!** button. The defaults select the most common project setup.

   <figure><img src="https://951240982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_fye9Ufg3vzJxwX5Hk%2Fuploads%2Fgit-blob-439c4cee1ba94c62588a844a621c9c8bb0b56af8%2F02_10%2008%2022.png?alt=media" alt=""><figcaption><p>Click the Create Project! button</p></figcaption></figure>
3. After the project loads, the Project Setup Wizard appears. Select which project type you would like such as **Standard Platformer** or **Standard Top Down**. These options are the quickest way to get a functional game running. If you would like to have an empty project, close the wizard by pressing the X button at the top right.

   <figure><img src="https://951240982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_fye9Ufg3vzJxwX5Hk%2Fuploads%2Fgit-blob-62d798bd253cb62393aec246be2ccc43eb0740eb%2Fimage.png?alt=media" alt=""><figcaption><p>Project Setup Wizard</p></figcaption></figure>

   1. If you selected a project type, wait for the project creation to finish.

   <figure><img src="https://951240982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_fye9Ufg3vzJxwX5Hk%2Fuploads%2Fgit-blob-f90c1ee5cf2ba3d87ab87221e21491482e1407d9%2Fimage.png?alt=media" alt=""><figcaption><p>Project Setup Wizard setting up a project</p></figcaption></figure>

You now have a FlatRedBall Project. You can run the project through the FlatRedBall Editor, or in Visual Studio.

<figure><img src="https://951240982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_fye9Ufg3vzJxwX5Hk%2Fuploads%2Fgit-blob-2100fe678b2a33459e5c461eecf92e17feb6a5c2%2Fimage.png?alt=media" alt=""><figcaption><p>Project in FlatRedBall after it's been created</p></figcaption></figure>

### Running your Project in FlatRedBall

To run your Project in FlatRedBall, click the play button. Notice that this tells you which Screen will load when the project starts.

<figure><img src="https://951240982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_fye9Ufg3vzJxwX5Hk%2Fuploads%2Fgit-blob-cba178bdeafe174338330ed13eb239ef6caa9693%2Fimage.png?alt=media" alt=""><figcaption><p>Play button in FlatRedBall</p></figcaption></figure>

Once the project is running you will see it in its own window.

<figure><img src="https://951240982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_fye9Ufg3vzJxwX5Hk%2Fuploads%2Fgit-blob-35753388d9ab3b8a7d4767869623373959cc21d0%2Fimage.png?alt=media" alt=""><figcaption><p>FlatRedBall Platformer Project</p></figcaption></figure>

### Running in Visual Studio

To run your project in Visual Studio:

1. Click the Visual Studio icon in FlatRedBall\\

   <figure><img src="https://951240982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_fye9Ufg3vzJxwX5Hk%2Fuploads%2Fgit-blob-3b032011cd50e9120563a672cb083959c75e9a1f%2Fimage.png?alt=media" alt=""><figcaption><p>Visual Studio Icon in FlatRedBall</p></figcaption></figure>
2. Wait for the project to load in Visual Studio

   <figure><img src="https://951240982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_fye9Ufg3vzJxwX5Hk%2Fuploads%2Fgit-blob-ef073b7a9f7d9f6dbad86d5c973b8fa11dfeec19%2Fimage.png?alt=media" alt=""><figcaption><p>FlatRedBall project in Visual Studio</p></figcaption></figure>
3. Press the Play button to build and run your project in Visual Studio. FlatRedBall projects are standard .NET projects, which means you can treat it as you would any other .NET project including debugging, NuGet packages, and full C# syntax support.

### What's next?

Now that you have FlatRedBall running on your machine, you can get started making games. Here are some next steps to consider:

* Join the [FlatRedBall Discord](https://discord.com/invite/dg7WsFv) - come say "hi" and tell us about what you want to do with FlatRedBall. We have an active community who loves to help new users.
* Check out the [Beefball tutorials](https://docs.flatredball.com/flatredball/tutorials/beefball) and other tutorials. These will get you up to speed on how to use the FlatRedBall Editor.
* If you prefer to dive right in to the docs, check out the [FlatRedBall Editor reference](https://docs.flatredball.com/flatredball/glue-reference) to see what it can do, or the [FlatRedBall API Documentation](https://docs.flatredball.com/flatredball/api) for info about working with FlatRedBall in code.
* Try things out! The best way to learn is by doing, so try making changes to the project and explore what is already there.
