> 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/tutorials/distribution/itch.io.md). # itch.io ### Introduction FlatRedBall Web games can be uploaded to itch.io. This guide provides a walkthrough for uploading your game. {% hint style="info" %} You must first publish your game through Visual Studio before uploading it to itch.io. For more information, see the [Distribution](/flatredball/tutorials/distribution.md#distributing-flatredball-web-games) page. {% endhint %} ### Uploading a Build Once you have published your build through Visual Studio, you should have a folder similar to the following image:

Note that at the time of this writing itch.io does not support .br (brotli compressed) files. These and .gz files can be removed to reduce the size of your build. To do this: 1. Search for .br files in your wwwroot folder 2. Delete all .br files 3. Repeat the search for .gz files in your wwwroot folder 4. Delete all .gz files

Search for *.br, select all files, then delete all files

Open the wwwroot and create a .zip file with the contents.

Next, log in to your itch.io account and select the option to **Upload new project.**

Fill in your project's information, but be sure to set **Kind of project** to **HTML**.

Click the Upload Files option and select your .zip file that you created earlier.

Click the Upload files button to upload a .zip file

Check the **This file will be played in the browser** option.

Check the option to indicate that this game is played in the browser

You can specify the resolution for your project. Typically you should have your project run at a multiple of your native resolution so that pixels draw correctly. If your game uses a smaller resolution for a pixel aesthetic, you may want to set the resolution at two or three times the native size. For example, consider a game which is set to a resolution of 398x224:

Resolution set to 398x224 in the FRB Editor

You can set the game to render at 300% scale by setting the size to 1194x672:

--- # 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/tutorials/distribution/itch.io.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.