패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소Erengun/Flutter-Riverpod-Quickstart-Template

Flutter-Riverpod-Quickstart-Template

⚡️ 프로덕션 준비 완료된 Flutter 빠른 시작 템플릿 — Riverpod, Freezed, GoRouter, Mason, API + 인증, 한 명령어로 이름 변경 및 아이콘 변경.

Flutter-Riverpod-Quickstart-Template 프로젝트 이미지
스타
140
포크
19
최근 푸시(UTC)
2026. 9. 8.
프로젝트 상태
활성

원본 README

아래는 영문 원문 스냅샷입니다. 최신 내용은 GitHub에서 확인하세요.

Stand With Palestine

Flutter Riverpod Template - 2025 Edition

Modern Flutter Architecture Template with Riverpod

A production-ready Flutter template built with the latest packages and best practices, supporting Flutter 3.32 and above. This template implements clean architecture principles and provides a robust foundation for building scalable applications.


Key Features
  • 🏗️ Clean Architecture with Domain-Driven Design
  • 🎯 Riverpod 2.6+ with code generation
  • 🔒 Built-in authentication pack with secure storage (Hive CE + AES-256)
  • 🌐 Type-safe API integration with Dio 5.8+
  • 📱 Responsive UI with adaptive widgets
  • 🌍 Internationalization ready with Easy Localization
  • 💾 Secure local storage with Hive CE
  • 🧪 Pre-configured unit testing for authentication and controller logic
  • ⚡ Modern navigation with GoRouter 14.8+
  • 🛠️ Custom linting and devtools configuration

Tech Stack

Core Libraries:

  • State Management: Riverpod 2.6.1, Freezed 3.0.6 (immutable state)
  • Network Layer: Dio 5.8.0, FPDart 1.1.0 for functional error handling
  • Local Storage: Hive CE 2.11.1 with AES-256 encryption
  • UI & Navigation: GoRouter 14.8.0, Google Fonts 6.2.1, Material 3

Developer Tools:

  • Flutter Lints 5.0.0
  • Build Runner, code generation
  • Custom linting rules (lint_rules.yaml)
  • Dart & Flutter DevTools support

Project Structure

lib/
├── common/            # Shared widgets and components
├── config/            # App configuration (theme etc.)
├── constants/         # App-wide constants (endpoints, assets)
├── core/              # Core functionality, network layer
├── features/          # Feature modules (authentication, home, ...)
│   └── authentication/
│       ├── data/
│       ├── domain/
│       └── presentation/
├── hive/              # Local storage setup and adapters
├── router/            # Navigation & routing
├── utils/             # Utility functions
├── main.dart          # App entry point
└── my_app.dart        # App configuration

Getting Started

Setup
  1. Clone the template:

    git clone https://github.com/Erengun/Flutter-Riverpod-2.0-Template.git my_app
    cd my_app
    
  2. Install dependencies:

    flutter pub get
    
  3. Generate code:

    dart run build_runner build --delete-conflicting-outputs
    
  4. Setup environment:

    cp .env.example .env
    
  5. Run the app:

    flutter run --flavor prod -t lib/main_prod.dart
    

Flavors (app names & package IDs)

This template ships with dev, staging, and prod flavors for Android and iOS.

Run commands
  • Dev:
    flutter run --flavor dev -t lib/main_dev.dart
    
  • Staging:
    flutter run --flavor staging -t lib/main_staging.dart
    
  • Prod:
    flutter run --flavor prod -t lib/main_prod.dart
    
Customize names and IDs

Authentication Module

The template includes a complete authentication system with secure credential storage and error handling.

How it works
  • Login & Registration: Uses Dio to POST to /api/login and /api/register endpoints.
  • Credential Caching: Credentials are securely cached in Hive CE using AES-256 encryption, with key derived per-device.
  • State Management: All authentication UI and logic is managed via Riverpod notifiers and state classes.
  • Error Handling: All network and validation errors are surfaced in the UI.
  • Loading State: UI reflects loading and error states for a smooth UX.
Test Credentials

You can test the authentication functionality using these credentials from reqres.in:

Login:

{
    "email": "eve.holt@reqres.in",
    "password": "cityslicka"
}

Register:

{
    "email": "eve.holt@reqres.in",
    "password": "pistol"
}

Example:

@riverpod
class LoginController extends _$LoginController {
  // ... state and logic here
  Future<LoginResponse> login({required String email, required String password}) async {
    // Handles login, error handling, caching, loading state etc.
  }
}

Testing

  • Integrated tests for auth controller logic (test/features/login_controller_test.dart)
  • Run tests with:
    flutter test
    

Documentation

  • Up-to-date documentation in this README
  • Code comments and examples throughout

Contributing

See our Contributing Guide for details on how to:

  • Set up your development environment
  • Run tests
  • Submit pull requests

License

This project is licensed under the MIT License - see the LICENSE file for details.


Contact

Eren Gun GitHub avatar
GitHub 작성자

Eren Gun ↗

Software Developer

Istanbul
언어DartCMakeC++SwiftHTMLCKotlinObjective-C

분류

사용 중인 의존성

의존성 목록 40 개

순위

프로젝트에 맞는 저장소를 선택하려면?

사용 목적에 따라 검색하고 개발 활동을 비교한 뒤 원본 저장소에서 요구 사항을 확인하세요.

  1. 이름, 작성자 또는 설명으로 검색하고 기술 주제로 범위를 좁힙니다.
  2. 스타, 포크, 최근 푸시를 함께 비교하세요. 스타는 관심의 지표이며 품질을 보장하지 않습니다.
  3. 사용하기 전에 GitHub에서 README, 라이선스, Issues를 확인하세요.

출처 및 관리

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗