Skip to content
Skills Library
Programming · Building & coding

flutter-init-project

/flutter-init-project

Initialize or reset a Flutter project into a production-ready baseline aligned with this repository's real Flutter projects: manual Riverpod setup, GoRouter routing, Material 3 configuration, shared services, shared widgets, design tokens, and either modular `lib/modules/` scaffolding or a simpler root-level `domain/infrastructure/presentation` structure when the app does not need feature modules. Use when bootstrapping a new project, replacing the default counter app, or standardizing an app foundation before feature development.

Repository
skills ↗
Licence
MPL-2.0
Last repository change
22.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
11
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.

Licence

MPL-2.0, otwarta.

What it does and when to use it

Initialize or reset a Flutter project into a production-ready baseline aligned with this repository's real Flutter projects: manual Riverpod setup, GoRouter routing, Material 3 configuration, shared services, shared widgets, design tokens, and either modular `lib/modules/` scaffolding or a simpler root-level `domain/infrastructure/presentation` structure when the app does not need feature modules. Use when bootstrapping a new project, replacing the default counter app, or standardizing an app foundation before feature development.

Original author description

Initialize or reset a Flutter project into a production-ready baseline aligned with this repository's real Flutter projects: manual Riverpod setup, GoRouter routing, Material 3 configuration, shared services, shared widgets, design tokens, and either modular `lib/modules/` scaffolding or a simpler root-level `domain/infrastructure/presentation` structure when the app does not need feature modules. Use when bootstrapping a new project, replacing the default counter app, or standardizing an app foundation before feature development.

How it works

  1. Skill Profile
  2. Required Resource Map
  3. Operating Procedure
  4. Non-Negotiable Rules
  5. Output Expectations
Original SKILL.md headings · 92 lines, 505 words
SKILL.md preview
---
name: flutter-init-project
description: >-
  Initialize or reset a Flutter project into a production-ready baseline
  aligned with this repository's real Flutter projects: manual Riverpod setup,
  GoRouter routing, Material 3 configuration, shared services, shared widgets,
  design tokens, and either modular `lib/modules/` scaffolding or a simpler
  root-level `domain/infrastructure/presentation` structure when the app does
  not need feature modules. Use when bootstrapping a new project, replacing the
  default counter app, or standardizing an app foundation before feature
  development.
---

# Flutter Init Project

Turn a raw Flutter app into a repeatable project foundation that is aligned with your architectural preferences.

## Skill Profile

- Architecture target: Clean Architecture foundation
- State management target: manual Riverpod without code generation
- Navigation target: GoRouter
- UI target: Material 3 with centralized tokens
- Main entry philosophy: minimal `main.dart`
- Project style options:
  - modular apps with `lib/modules/`
  - simpler apps with root `lib/domain`, `lib/infrastructure`, `lib/presentation`
- Dependency policy preserved from previous iteration: `flutter_riverpod`, `go_router`, `google_fonts`
- Skill version preserved from previous iteration: `2.1.0`

## Required Resource Map

Read these reference files before editing project files:

1. [`references/core/rules.md`](references/core/rules.md)
   Use for architectural constraints, dependency limits, and cleanup rules.
2. [`references/core/specs.md`](references/core/specs.md)
   Use for the target directory tree and design-token schema.
3. [`references/examples/before-after.md`](references/examples/before-after.md)
   Use to see the expected transformation from default Flutter project to initialized baseline.

Use these template assets as the canonical bootstrap base:

- [`assets/bootstrap-template/pubspec.yaml`](assets/bootstrap-template/pubspec.yaml)
- [`assets/bootstrap-template/lib/config/theme/app_config.dart`](assets/bootstrap-template/lib/config/theme/app_config.dart)
- [`assets/bootstrap-template/lib/config/theme/app_theme.dart`](assets/bootstrap-template/lib/config/theme/app_theme.dart)
- [`assets/bootstrap-template/lib/config/router/app_router.dart`](assets/bootstrap-template/lib/config/router/app_router.dart)
- [`assets/bootstrap-template/lib/config/config.dart`](assets/bootstrap-template/lib/config/config.dart)
- [`assets/bootstrap-template/lib/main.dart`](assets/bootstrap-template/lib/main.dart)

## Operating Procedure

### 1. Environment Verification
- Confirm you are at the root of a Flutter project.
- Check the current `pubspec.yaml` state.

### 2. Normalize Dependencies
- Apply the baseline dependency set from [`assets/bootstrap-template/pubspec.yaml`](assets/bootstrap-template/pubspec.yaml).
- Run `flutter pub get` immediately to sync the project.

### 3. Remove Starter Boilerplate
- Delete `lib/main.dart` content.
- Delete `test/widget_test.dart` (or refactor it if it's strictly required).

### 4. Scaffold the Project Structure
- Create the folder structure as defined in [`references/core/specs.md`](references/core/specs.md).
- Choose the structure intentionally:
  - modular apps: `lib/modules/<feature_name>/...`
  - simpler apps: root `lib/domain`, `lib/infrastructure`, `lib/presentation`

### 5. Generate Configuration
- **Design Tokens**: Generate `lib/config/theme/app_config.dart` (refer to [`assets/bootstrap-template/lib/config/theme/app_config.dart`](assets/bootstrap-template/lib/config/theme/app_config.dart)).
- **App Theme**: Generate `lib/config/theme/app_theme.dart` (refer to [`assets/bootstrap-template/lib/config/theme/app_theme.dart`](assets/bootstrap-template/lib/config/theme/app_theme.dart)).
- **App Router**: Generate `lib/config/router/app_router.dart` (refer to [`assets/bootstrap-template/lib/config/router/app_router.dart`](assets/bootstrap-template/lib/config/router/app_router.dart)).
- **Router Bridge**: If auth-driven redirects are needed, add a dedicated router notifier/provider instead of pushing redirect logic into widgets.
- **Barrel Files**: Create `lib/config/config.dart` to export the theme and router modules.

### 6. Rebuild the App Entry Point
- Generate the new `lib/main.dart` connecting `ProviderScope` and `MaterialApp.router` (refer to [`assets/bootstrap-template/lib/main.dart`](assets/bootstrap-template/lib/main.dart)).

### 7. Validate the Baseline
- Run `flutter analyze` to ensure no syntax or import errors exist.
- Verify that basic routing (initial location) is functional.

## Non-Negotiable Rules

- Do not introduce Riverpod code generation packages for this bootstrap skill.
- Keep routing logic out of `main.dart`.
- Keep theming logic out of `main.dart`.
- Use tokenized spacing, radius, colors, shadows, durations, and icon sizes instead of magic numbers.
- Create the `lib/config/config.dart` barrel and ensure it exports theme and router modules.
- Use `ThemeData(useMaterial3: true)`.
- Do not force `lib/modules/` into small projects that are clearer with a flatter root architecture.

## Output Expectations

When using this skill, deliver a foundation that is ready for later feature modules:

- `lib/config/` exists and is coherent.
- Either `lib/modules/` exists for modular apps or a flat root architecture exists for small apps.
- `lib/shared/` exists for reusable cross-feature code.
- The entry point is minimal and maintainable.
- The project no longer contains the default Flutter starter structure.
Files in this package (11)
  • SKILL.md 5 KB
  • agents/openai.yaml 1 KB
  • assets/bootstrap-template/pubspec.yaml 1 KB
  • assets/bootstrap-template/lib/main.dart 1 KB
  • assets/bootstrap-template/lib/config/config.dart 1 KB
  • assets/bootstrap-template/lib/config/router/app_router.dart 1 KB
  • assets/bootstrap-template/lib/config/theme/app_config.dart 3 KB
  • assets/bootstrap-template/lib/config/theme/app_theme.dart 2 KB
  • references/core/rules.md 2 KB
  • references/core/specs.md 2 KB
  • references/examples/before-after.md 3 KB

Versions

The database has no other skills named flutter-init-project.

Database snapshot: 13.11.2026 · package version 77310b2b58ea (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100flutter-expert
    Use when building cross-platform applications with Flutter 3+ and Dart. Invoke for widget development, Riverpod/Bloc state management, GoRouter navigation, platform-specific implementations, performance optimization.
  • 90flutter-expert
    Use when building cross-platform applications with Flutter 3+ and Dart. Invoke for widget development, Riverpod/Bloc state management, GoRouter navigation, platform-specific implementations, performance optimization.
  • 100flutter-expert
    Use when working in a Flutter project - pubspec.yaml, *.dart files, lib/main.dart, analysis_options.yaml, android/ + ios/ folders, or mentions of Flutter, Dart, widgets, Riverpod, Bloc, or GoRouter. Builds features, state management, navigation, platform channels/FFI, and tests…
  • 100flutter-expert
    Use when building cross-platform applications with Flutter 3+ and Dart. Invoke for widget development, Riverpod/Bloc state management, GoRouter navigation, platform-specific implementations, performance optimization.
  • 90flutter-dev
    Flutter cross-platform development guide covering widget patterns, Riverpod/Bloc state management, GoRouter navigation, performance optimization, and platform-specific implementations. Includes const optimization, responsive layouts, testing strategies, and DevTools profiling.…
  • 100feature
    Build a new Flutter feature end to end in a feature-first, layered structure (domain, data, presentation) with Riverpod 3, loading/error/empty states and tests. Use when the user asks to add a screen, flow or feature to a Flutter app.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.