Deploy Your App

These steps publish your app with GitHub Pages, at an address like https://your-username.github.io/animator/.

1. Build the files to publish. In the animator folder, run:

gleam dev publish

This creates a public folder containing index.html, animator.css, and app.mjs, your whole app compiled into one file. Your other source files aren't in it.

If your extension added other files that the page loads, such as images, copy them into public too.

2. Create a GitHub account. If you don't have one, sign up for a free account. Your username will be part of your app's address.

3. Create a repository. Click the + at the top right of any GitHub page and choose New repository. Name it animator (but you can choose any name you prefer), choose Public, turn on Add README, and click Create repository.

4. Upload your files. On your repository's page, open the Add file menu and choose Upload files. Drag in the three files from your public folder (the files, not the folder itself). Choose Commit directly to the main branch and click Commit changes.

5. Turn on GitHub Pages. On your repository's page, click Settings, then Pages in the sidebar. Under Build and deployment, set Source to Deploy from a branch, set Branch to main and / (root), and click Save.

It can take up to 10 minutes for your app to appear. The Pages settings page then shows your address and a Visit site button. Open your app there to make sure it works.

Your published app saves drawings separately from your copy on localhost, so the drawings you made there won't appear at first. They're still saved at the localhost address where you made them.

To publish a new version, run gleam dev publish again and upload the three files again, which replaces the old ones. It can take a few minutes for the new version to appear.

If you would like to automate the publishing process, your coding agent can help you with that.