Hosting your Flutter web app on GitLab Pages

(GitLab, not GitHub)

Update: For a video tutorial of this post and a bonus part on how to create a subdomain from your dev branch, check out my talk at the Flutteristas 2025 conference here.

You’ve got a great Flutter web app, that does something and does it well. It doesn’t need a server, you just want to host it somewhere, for free, so that all the world can revel in its goodness. You hear that it can be done in GitLab — what a coincidence, the code is already in GitLab! So you’re ready to go, right?

…Right?

I’ve seen so. Many. Tutorials on how to host a Flutter web app on GitHub pages, but the few I found on GitLab were out of date (though they were still useful! Thanks especially to Igor Steblii).

So here it is: The step by step tutorial on how to host your app in GitLab.

• Create your app and run it locally
• Create the gitlab-ci file
• Run pipeline to create your site

Check out the repo here and the live site here.

Create your app