https://github.com/flutter/games
Home of the Flutter Casual Games Toolkit and other Flutter gaming templates
https://github.com/flutter/games
Last synced: 10 months ago
JSON representation
Home of the Flutter Casual Games Toolkit and other Flutter gaming templates
- Host: GitHub
- URL: https://github.com/flutter/games
- Owner: flutter
- License: other
- Created: 2023-10-18T18:03:36.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-25T05:03:24.000Z (11 months ago)
- Last Synced: 2025-04-06T05:09:33.424Z (11 months ago)
- Language: Dart
- Size: 16.4 MB
- Stars: 666
- Watchers: 54
- Forks: 672
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# games
[](https://github.com/flutter/games/actions/workflows/main.yml)
Home to the official code for the Flutter Casual Games Toolkit
and other Flutter gaming templates.
Visit [flutter.dev/games](https://flutter.dev/games) for more information.
If you're new to Flutter, you first need to install the
[Flutter SDK](https://flutter.dev/).
## Organization
The projects in this repository are divided into two broad categories:
1. **Templates.** A small number of starting points for your game project.
Templates are intended to give you a simple project structure
on top of which you can build your game.
They differ to accommodate different game types,
from the simplest casual games through drag&drop board games
to 2D platformers.
2. **Samples.** Intended to show functionality beyond the basics,
such as multiplayer or ads integration.
```text
.
├── templates
│ ├── basic
│ ├── card
│ └── endless_runner
└── samples
├── ads
├── multiplayer
└── ...
```
## How to use
The easiest way to get any of the samples and templates from this repository
is to install the
[`sample_downloader` tool](https://pub.dev/packages/sample_downloader)
and use it.
On the command line, while having the
[Flutter SDK installed](https://docs.flutter.dev/get-started/install),
run the following command:
```shell
dart pub global activate sample_downloader
```
Then, from any directory, run the newly installed tool
and follow its instructions.
```shell
sample_downloader
```
### The manual way
If, for any reason, you prefer not to use the `sample_downloader` tool,
follow these steps.
1. Clone this repository.
To minimize download size, you can use a
[partial clone](https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/):
```shell
git clone --filter=blob:none https://github.com/flutter/games.git
```
(Alternatively, you can
[download the ZIP file](https://github.com/flutter/games/archive/refs/heads/main.zip)
and uncompress it on your workstation.)
2. `cd` into the project you are interested in. For example:
```shell
cd templates/card
```
(Alternatively, you can copy the contents of a project to somewhere else,
and change to that directory.)
3. (Optional) Rename the project with the
[`rename` tool](https://pub.dev/packages/rename).
4. Open the project in your favorite editor and enjoy.
## Interested in contributing?
See the [contributor's guide](CONTRIBUTING.md)!
## Questions or issues?
If you have a general question about one of these samples or how to adapt its
techniques for one of your own apps, try one of these resources:
* [The FlutterDev Discord](https://discord.gg/rflutterdev)
* [The Flame Discord](https://discord.com/invite/pxrBmy4)
* [StackOverflow](https://stackoverflow.com/questions/tagged/flutter)
If you run into a bug in one of the samples, please file an issue in the
[`flutter/flutter` issue tracker](https://github.com/flutter/flutter/issues).