aks5686_flutter_ui_library

Production-ready Flutter component library with design tokens, Dark Mode, and zero third-party dependencies.

Requirements

Flutter 3.10+
Dart 3.0+

Installation

Add to your pubspec.yaml:

dependencies:
  aks5686_flutter_ui_library:
    git:
      url: https://github.com/aks5686/flutter-ui-library.git
      ref: main

Usage

import 'package:aks5686_flutter_ui_library/aks5686_flutter_ui_library.dart';

// Button
PrimaryButton(
  label: 'Get Started',
  onPressed: () {},
)

// Input
TextInput(
  label: 'Email',
  controller: emailController,
)

// Badge
Badge(text: 'New', variant: BadgeVariant.primary)

Components

Buttons: PrimaryButton, SecondaryButton, DestructiveButton, GhostButton, IconButton
Inputs: TextInput, SecureInput
Feedback: LoadingView, EmptyStateView, ToastView
Cards: CardView
Badges: Badge
Navigation: BackButton

Design Tokens

All components use semantic tokens from lib/src/tokens/ — colors, typography, spacing, and radius.

Contributing & Releases

Making a release

Make changes and ensure tests pass:

   flutter test
   flutter analyze

Commit with release prefix:

   git commit -m "release: v1.2.0 — description"
   git push origin main

CI automatically runs tests, syncs pubspec.yaml version, and creates GitHub release.

Version format

Patch: v1.0.1 — bug fixes
Minor: v1.1.0 — new components
Major: v2.0.0 — breaking changes

License

MIT