narakai / flutter-templates

A repository contains Flutter templates that are used by Nimble developers

Flutter Templates

All the templates can be used to kick off a new Flutter project quickly.

Features

• Supports Android and iOS platforms (Web and Desktop are not yet supported).
• Clean Architecture with MVVM and pre-built foundational components.
• Pre-set environments: Staging and Production. Environment variables are supplied through .env files through flutter_config.
• Dependency Injection (DI), State Management, and Navigating with get_it, flutter_riverpod, and go_router.
• Networking with dio and retrofit, JSON serializing with json_serializable.
• Localization integrated in 3 initial languages.
• Testing-ready (unit, integration, and widget testing), production and deployment-ready (to Firebase, Play Store, TestFlight, and AppStore).
• Built-in GitHub templates & CI/CD workflows integrated with GitHub Actions to perform static code analysis, test, build and deploy app builds to app distribution services or app stores.

Optional (enable by generator command parameters)

• Specify the default JSON field renaming format with json_serializable between support values: none, kebab, snake, and pascal.
• Integrate permissions requesting & checking with permission_handler and its necessary basic setup.
• Code coverage integration by Codecov.

Use the template

Prerequisites

Before using the template, ensure that you have installed the following prerequisites on your system:

• Flutter 3.10.5
• Mason CLI 0.1.0-dev.44

Set up a new project

Follow these steps to set up a new project from the template:

1. Clone or download this repository to your local machine.

2. Fetch all required bricks by running the command:

   $ mason get

3. Generate the new project by running the following command with supported arguments:

   $ mason make template and then provide necessary inputs.

   or

   $ mason make template -c mason-config.json to provide necessary inputs via a JSON file, e.g., mason-config.json for the sample project.

Once the project is generated at /{project_name}, please refer to the Getting Started documentation to make it ready for development.

That's it! You have now set up a new Flutter project using the template 🎉

Note
You can find detailed information on make command options and usage in the Mason documentation.

Documentation

Check out the Wiki page to access the complete documentation.

License

This project is Copyright (c) 2014 and onwards. It is free software, and may be redistributed under the terms specified in the LICENSE file.

About

This project is maintained and funded by Nimble.

We love open source and do our part in sharing our work with the community! See our other projects or hire our team to help build your product.