Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev7.5.0

theme_extensions_builder_annotation

Anotações para o theme_extensions_builder. Este pacote não faz nada sem o theme_extensions_builder.

AndroidiOSLinuxmacOSWebWindows
Downloads em 30 dias
193 mil
Curtidas
4
Pontos Pub
160

Instalar pacote

flutter pub add theme_extensions_builder_annotation

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um pacote Dart que fornece anotações para o theme_extensions_builder, permitindo a criação e gerenciamento simplificados de extensões de tema em aplicativos Flutter. Serve como companheiro do theme_extensions_builder, oferecendo suporte à geração de código em tempo de compilação por meio de anotações. Este pacote não contém lógica executável, mas melhora a produtividade do desenvolvedor ao simplificar a configuração de temas e reduzir o código repetitivo. É projetado exclusivamente para funcionar com o pacote theme_extensions_builder.

Casos de uso

  • Gerando classes de extensão de tema
  • Simplificando a configuração do tema
  • Habilitar manipulação de temas segura por tipo
  • Reduzindo o código repetitivo na configuração do tema
  • Apoiar fluxos de trabalho de tematização dinâmica

Principais recursos

  • Geração de código em tempo de compilação
  • Integração com theme_extensions_builder
  • Definições de tema seguras por tipo
  • Sobrecarga mínima de tempo de execução
  • Desenvolvimento orientado por anotações

Indicado para

  • Desenvolvedores Flutter usando theme_extensions_builder
  • Equipes que priorizam sistemas de tema sustentáveis
  • Projetos que exigem soluções de tematização escalonáveis
  • Desenvolvedores que buscam reduzir o código boilerplate
  • Aplicativos com requisitos complexos ou dinâmicos de tema

Considerações

  • Requerido para funcionar theme_extensions_builder
  • Sem funcionalidade independente
  • Dependente do build_runner para geração de código
  • Limitado ao uso em projetos Flutter compatíveis
  • Não adequado para temas estáticos simples

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

theme_extensions_builder

pub package License: MIT

📖 Full documentation: packages/theme_extensions_builder/README.md

theme_extensions_builder is a powerful code generator for Flutter's ThemeExtension classes. It eliminates boilerplate code by automatically generating copyWith, lerp, ==, and hashCode methods, along with convenient BuildContext extensions for easy theme access.

🎯 Quick Links

📦 Installation

Add the packages to your project:

flutter pub add theme_extensions_builder_annotation
flutter pub add --dev theme_extensions_builder
flutter pub add --dev build_runner

Or add to pubspec.yaml:

dependencies:
  theme_extensions_builder_annotation: ^7.5.0

dev_dependencies:
  build_runner: ^2.13.0
  theme_extensions_builder: ^7.5.0

🚀 Quick Start

Using @ThemeExtensions

For classes extending ThemeExtension:

import 'package:flutter/material.dart';
import 'package:theme_extensions_builder_annotation/theme_extensions_builder_annotation.dart';

part 'app_theme.g.theme.dart';

@ThemeExtensions()
class AppTheme extends ThemeExtension<AppTheme> with _$AppTheme {
  const AppTheme({
    required this.primaryColor,
    required this.spacing,
  });

  final Color primaryColor;
  final double spacing;
}

Generate code:

dart run build_runner build

Use in your app:

Widget build(BuildContext context) {
  final theme = context.appTheme;
  
  return Container(
    padding: EdgeInsets.all(theme.spacing),
    color: theme.primaryColor,
  );
}
Using @ThemeGen

For standalone theme data classes:

@ThemeGen()
class ButtonThemeData with _$ButtonThemeData {
  const ButtonThemeData({
    required this.backgroundColor,
    this.borderRadius = 8.0,
  });

  final Color backgroundColor;
  final double borderRadius;

  static ButtonThemeData? lerp(ButtonThemeData? a, ButtonThemeData? b, double t) =>
      _$ButtonThemeData.lerp(a, b, t);
}

📋 Choose Your Annotation

@ThemeExtensions (Recommended)

For classes extending Flutter's ThemeExtension - ideal for most use cases.

Perfect for:

  • Full Flutter theme integration
  • Automatic theme switching with lerp animations
  • Easy access via BuildContext (e.g., context.appTheme)

Generates:

  • Complete ThemeExtension implementation with copyWith and lerp
  • BuildContext extension for convenient access
  • Equality operators and hashCode
@ThemeGen

For standalone theme data classes without ThemeExtension inheritance.

Perfect for:

  • Custom theme systems outside standard Flutter themes
  • Maximum control over class structure
  • Nested theme data objects

Generates:

  • copyWith and merge methods
  • Static lerp method
  • Equality operators and hashCode

📖 Example

Check out the example project for a comprehensive Flutter app with:

  • 5 Theme Extensions: App, Button, Card, Typography, and Spacing themes
  • Theme Switching: Seamless light/dark mode transitions
  • Custom Components: Buttons, cards, and typography showcases
  • Best Practices: Real-world organization patterns

🛠️ Development

The repository is a pub workspace: one flutter pub get at the root resolves every package, including the example app.

flutter pub get
scripts/prepare_push.sh     # format, analyze, build and test every package
scripts/update_goldens.sh   # regenerate the golden files after a generator change

The generator tests run on the Dart SDK alone. The Flutter classes the fixtures use are small stand-ins in packages/theme_extensions_builder/test/fixtures/flutter_stubs.dart, with the same lerp and merge signatures as the real ones. The example app is where the generated code meets the real framework, so CI regenerates and analyzes it on every push.

📄 License

MIT License - see the LICENSE file for details.

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote

Rankings