flutter_basic_kit_library 0.0.1

A collection of basic Flutter UI widgets and app-scaffolding utilities used across cleanwash projects.

flutter_basic_kit_library

Flutter/Dart 프로젝트를 새로 시작할 때 반복적으로 붙이는 기본 UI 위젯과 앱 스캐폴딩(라우팅, DI, 네트워킹, 모델 코드 생성) 관련 패키지들을 한 번에 모아둔 스타터 킷입니다. 이 라이브러리를 추가하면 아래 패키지들이 함께 설치됩니다.

포함된 패키지

UI

• cupertino_icons — iOS 스타일 아이콘
• curved_navigation_bar — 곡선형 하단 내비게이션 바
• google_fonts — Google Fonts 연동
• flutter_native_splash — 스플래시 화면 생성 도구

앱 구조 / 상태 관리

• go_router — 선언형 라우팅
• provider — 상태 관리
• get_it — 서비스 로케이터
• injectable — get_it 기반 의존성 주입 코드 생성

네트워킹 / 모델

• dio — HTTP 클라이언트
• retrofit — dio 기반 타입 세이프 REST 클라이언트 어노테이션
• freezed_annotation — 불변 모델(freezed) 어노테이션
• json_annotation — JSON 직렬화 어노테이션

freezed, json_serializable, retrofit_generator, injectable_generator, build_runner는 코드 생성 시에만 필요한 개발 도구라 dev_dependencies로 포함되어 있습니다. 이 라이브러리를 설치한다고 자동으로 코드 생성이 되는 것은 아니며, 이 도구들로 만드는 모델/API 클라이언트/DI 코드는 이 라이브러리를 사용하는 프로젝트에서 직접 작성하고, 각자의 프로젝트에 build_runner 등을 dev_dependencies로 추가한 뒤 아래처럼 실행해야 합니다.

dart run build_runner build --delete-conflicting-outputs

설치

dependencies:
  flutter_basic_kit_library: ^0.0.1

flutter pub get

언제 쓰면 좋은가

• 매번 새 프로젝트를 만들 때마다 라우팅(go_router), DI(get_it/injectable), 네트워킹(dio/retrofit) 관련 패키지를 하나하나 추가하는 게 번거로울 때
• cleanwash 계열 프로젝트에서 UI/구조 컨벤션을 통일하고 싶을 때

버전 관리

이 패키지는 Semantic Versioning을 따릅니다.

• MAJOR: 기존 사용 방식과 호환되지 않는 변경(포함된 패키지의 breaking change 반영 등)
• MINOR: 하위 호환을 유지하며 새 패키지 추가/기능 추가
• PATCH: 버그 수정, 포함된 패키지의 마이너 버전 업데이트

버전별 변경 사항은 CHANGELOG.md를 참고하세요.

사용 예시

import 'package:flutter_basic_kit_library/flutter_basic_kit_library.dart';

Additional information

• 저장소: https://github.com/cleanwash/flutter_basic_kit_library
• 이슈/버그 제보: GitHub Issues