Communitygithub.com

flutter/flutter-add-widget-preview

Añade vistas previas interactivas de widgets al proyecto usando el sistema previews.dart. Úsalo al crear nuevos componentes de UI o actualizar pantallas existentes para garantizar un diseño consistente y pruebas interactivas.

¿Qué es flutter-add-widget-preview?

Esta habilidad para agentes de IA, como Claude Code o Cursor, permite generar automáticamente vistas previas interactivas de widgets en proyectos Flutter mediante el sistema `previews.dart`. Esto es especialmente útil para desarrolladores que desean inspeccionar visualmente los cambios en los componentes de la interfaz de usuario sin necesidad de ejecutar la aplicación completa o recargar constantemente el emulador. La habilidad se integra en el flujo de trabajo del agente, detectando cuándo se crean o modifican widgets y generando archivos `preview.dart` asociados. Estos archivos contienen configuraciones simplificadas para mostrar el widget en diferentes estados (por ejemplo, vacío, con datos, con errores) directamente desde el editor. Al mantener un diseño consistente y facilitar la verificación visual rápida, reduce la fricción en el desarrollo de UI y mejora la colaboración en equipo al compartir ejemplos funcionales del comportamiento de los componentes. Funciona en plataformas como VS Code, Cursor y otras que soporten la vista previa de Dart/Flutter, y su implementación se basa en las convenciones de `previews.dart` de la comunidad Flutter.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/flutter/skills/tree/main/skills/flutter-add-widget-preview

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace flutter-add-widget-preview?

Añade vistas previas interactivas de widgets al proyecto usando el sistema previews.dart. Úsalo al crear nuevos componentes de UI o actualizar pantallas existentes para garantizar un diseño consistente y pruebas interactivas.

¿Qué hace?

Genera automáticamente archivos preview.dart junto a cada widget nuevo o modificado, permitiendo visualizar el widget en múltiples estados sin necesidad de ejecutar la app completa.

¿Por qué es útil?

  • Acelera el desarrollo de UI al proporcionar retroalimentación visual instantánea.
  • Mantiene la consistencia del diseño al mostrar ejemplos reales de uso.
  • Facilita la colaboración en equipo permitiendo compartir vistas previas funcionales.

Plataformas compatibles

  • VS Code
  • Cursor
  • Cualquier editor que soporte la vista previa de Dart/Flutter

Cómo funciona

  1. Detecta la creación o modificación de un widget Flutter.
  2. Genera un archivo preview.dart en el mismo directorio.
  3. Incluye configuraciones para diferentes estados (vacío, con datos, con errores).
  4. El editor muestra automáticamente la vista previa interactiva.

Ejemplo de uso

// En mi_widget.dart
class MiWidget extends StatelessWidget {
  final String titulo;
  final bool cargando;
  // ...
}

// El agente genera automáticamente:
// mi_widget_preview.dart

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

void main() {
  runApp(
    MaterialApp(
      home: Scaffold(
        body: ListView(
          children: [
            MiWidget(titulo: 'Hola', cargando: false),
            MiWidget(titulo: 'Cargando...', cargando: true),
            MiWidget(titulo: '', cargando: false),
          ],
        ),
      ),
    ),
  );
}

Configuración

No requiere configuración adicional. Solo asegúrate de tener la extensión Dart/Flutter instalada en tu editor.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

flutter/flutter-accessibility

Configure your Flutter app to support assistive technologies like Screen Readers

flutter/flutter-accessibility-audit

Triggers an accessibility scan through the widget_inspector and automatically adds Semantics widgets or missing labels to the source code.

flutter/flutter-adding-home-screen-widgets

Adds home screen widgets to a Flutter app for Android and iOS. Use when providing glanceable app information or quick actions on the device home screen.

flutter/flutter-add-integration-test

Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests. Use when adding integration testing to a project, exploring UI components via MCP, or automating user flows with the integration_test package.

flutter/flutter-add-widget-test

Implement a component-level test using `WidgetTester` to verify UI rendering and user interactions (tapping, scrolling, entering text). Use when validating that a specific widget displays correct data and responds to events as expected.

flutter/flutter-animating-apps

Implements animated effects, transitions, and motion in a Flutter app. Use when adding visual feedback, shared element transitions, or physics-based animations.

flutter/flutter-animation

Add animated effects to your Flutter app

flutter/flutter-apply-architecture-best-practices

Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use when structuring a new project or refactoring for scalability.

flutter/flutter-app-size

Measure and reduce the size of the Flutter app bundle, APK, or IPA

flutter/flutter-architecting-apps

Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use when structuring a new project or refactoring for scalability.

flutter/flutter-architecture

Use the Flutter team's recommended app architecture

flutter/flutter-building-forms

Builds Flutter forms with validation and user input handling. Use when creating login screens, data entry forms, or any multi-field user input.

flutter/flutter-building-layouts

Builds Flutter layouts using the constraint system and layout widgets. Use when creating or refining the UI structure of a Flutter application.

flutter/flutter-building-plugins

Builds Flutter plugins that provide native interop for other apps to use. Use when creating reusable packages that bridge Flutter with platform-specific functionality.

flutter/flutter-build-responsive-layout

Use `LayoutBuilder`, `MediaQuery`, or `Expanded/Flexible` to create a layout that adapts to different screen sizes. Use when you need the UI to look good on both mobile and tablet/desktop form factors.

flutter/flutter-caching

Cache data in a Flutter app

flutter/flutter-caching-data

Implements caching strategies for Flutter apps to improve performance and offline support. Use when retaining app data locally to reduce network requests or speed up startup.

flutter/flutter-concurrency

Execute long-running tasks in a background thread in Flutter

flutter/flutter-databases

Work with databases in a Flutter app

flutter/flutter-embedding-native-views

Embeds native Android, iOS, or macOS views into a Flutter app. Use when integrating complex native components like maps or web views.

Skills relacionados