kitterial 1.0.0

A comprehensive Flutter package providing modern, customizable UI templates for common app screens with built-in animations and theming support.

Kitterial

A modern Flutter UI template library designed for building beautiful, consistent, and accessible applications.

Features

Authentication Templates

• Login Template

  • Split screen layout support
  • Social login integration
  • Modern form styling
  • Theme customization

• Signup Template

  • Multi-step form workflow
  • Progress indicators
  • Form validation
  • Flexible layout options

• OTP Verification Template

  • Enhanced digit input
  • Timer visualization
  • Auto-advance behavior
  • Status feedback

• Forgot Password Template

  • Clear process steps
  • Visual feedback
  • Success confirmation
  • Error handling

Feedback Templates

• Empty State Template

  • Multiple layout options
  • Customizable illustrations
  • Action buttons
  • Modern styling

• Error Template

  • Recovery suggestions
  • Action buttons
  • Layout variations
  • Status handling

• Success Template

  • Next steps suggestions
  • Celebration animations
  • Action buttons
  • Modern design

• Upload Status Template

  • File details display
  • Multiple progress types
  • Action controls
  • Status feedback

Profile & Settings Templates

• Profile Template

  • Stats visualization
  • Achievement badges
  • Activity timeline
  • Modern layout options

• Settings Template

  • Quick actions
  • Search functionality
  • Modern controls
  • Group organization

Getting Started

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  kitterial: ^1.0.0

Install packages from the command line:

flutter pub get

Usage

Import the package:

import 'package:kitterial/kitterial.dart';

Basic usage example:

class LoginScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: LoginTemplate(
        configuration: LoginTemplateConfiguration(
          layoutType: LoginLayoutType.split,
          title: 'Welcome Back',
          subtitle: 'Sign in to continue',
          onLogin: (email, password) async {
            // Handle login
          },
        ),
      ),
    );
  }
}

Customization

All templates support extensive customization through their configuration classes:

SettingsTemplate(
  configuration: SettingsTemplateConfiguration(
    layoutType: SettingsLayoutType.card,
    showSearch: true,
    quickActions: [
      QuickAction(
        icon: Icons.dark_mode,
        label: 'Dark Mode',
        onTap: () {
          // Toggle dark mode
        },
      ),
    ],
    groups: [
      SettingsGroup(
        title: 'Appearance',
        items: [
          SettingsItem(
            title: 'Theme',
            type: SettingsItemType.select,
            // ...
          ),
        ],
      ),
    ],
  ),
)

Theming

Kitterial supports comprehensive theming through the KitterialTheme:

KitterialTheme(
  theme: KitterialThemeData(
    spacing: KitterialSpacing(
      xs: 4.0,
      sm: 8.0,
      md: 16.0,
      lg: 24.0,
      xl: 32.0,
    ),
    typography: KitterialTypography(
      // ...
    ),
  ),
  child: MyApp(),
)

Examples

Check out the example directory for complete demos of all templates and features.