{"id":36351156,"url":"https://github.com/developerrejaul/flutter_beautify","last_synced_at":"2026-04-05T06:01:24.575Z","repository":{"id":324263072,"uuid":"1096622637","full_name":"DeveloperRejaul/flutter_beautify","owner":"DeveloperRejaul","description":"A beautiful custom widget cli for Flutter.","archived":false,"fork":false,"pushed_at":"2026-04-03T15:07:35.000Z","size":622,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T15:14:44.332Z","etag":null,"topics":["dart","flutter","flutter-ui","flutterapp","flutterappdesign","fluutecli"],"latest_commit_sha":null,"homepage":"https://developerrejaul.github.io/flutter_beautify/","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DeveloperRejaul.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-14T17:39:36.000Z","updated_at":"2026-04-03T15:13:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/DeveloperRejaul/flutter_beautify","commit_stats":null,"previous_names":["developerrejaul/flutter_beautify"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/DeveloperRejaul/flutter_beautify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeveloperRejaul%2Fflutter_beautify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeveloperRejaul%2Fflutter_beautify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeveloperRejaul%2Fflutter_beautify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeveloperRejaul%2Fflutter_beautify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DeveloperRejaul","download_url":"https://codeload.github.com/DeveloperRejaul/flutter_beautify/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeveloperRejaul%2Fflutter_beautify/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31426193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T02:22:46.605Z","status":"ssl_error","status_checked_at":"2026-04-05T02:22:33.263Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dart","flutter","flutter-ui","flutterapp","flutterappdesign","fluutecli"],"created_at":"2026-01-11T13:34:18.548Z","updated_at":"2026-04-05T06:01:24.538Z","avatar_url":"https://github.com/DeveloperRejaul.png","language":"Dart","readme":"# 🎨 Flutter Beautify\n\n[![Pub Version](https://img.shields.io/pub/v/flutter_beautify.svg)](https://pub.dev/packages/flutter_beautify)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Dart SDK](https://img.shields.io/badge/Dart-3.9.2+-blue.svg)](https://dart.dev)\n[![Platform](https://img.shields.io/badge/platform-android%20%7C%20ios%20%7C%20web-lightgrey)](https://flutter.dev)\n\n\u003e A production-grade command-line interface tool for scaffolding 26+ pre-built, customizable Flutter UI components with Material Design 3 compliance. Accelerate development workflow by generating boilerplate widget code with factory method patterns in seconds.\n\n## ✨ Key Features\n\n- **🎁 26 Production-Ready Components** - Professionally crafted UI widgets following Material Design 3 specifications\n- **🏭 Factory Method Pattern** - 60+ factory variants (3-4 per widget) for flexible customization\n- **⚡ CLI-First Workflow** - Fast command-line integration for rapid scaffolding\n- **🔧 Configuration Management** - Flexible directory path configuration via interactive prompts\n- **📚 Comprehensive Documentation** - Built-in examples and usage patterns for every component\n- **🎬 Animation Support** - Native support for transitions, loading spinners, and custom animations\n- **📦 Zero Dependencies** - Lightweight CLI with minimal external dependencies\n- **🚀 Quick Integration** - Copy templates directly into projects with automatic path creation\n\n---\n\n## 📋 Table of Contents\n\n- [Installation](#installation)\n- [Quick Start Guide](#quick-start-guide)\n- [CLI Commands Reference](#cli-commands-reference)\n- [Component Catalog](#component-catalog)\n\n---\n\n## Installation\n\n### Prerequisites\n\n- **Dart SDK**: 3.9.2 or higher\n- **Flutter SDK**: Latest stable version (for component usage)\n- **macOS/Linux/Windows**: Supported on all platforms\n\n### Method 1: From pub.dev (Recommended)\n\nInstall globally from pub.dev:\n\n```bash\ngit clone https://github.com/DeveloperRejaul/flutter_beautify.git\ndart pub global activate --source path .\n```\n\n### Uninstall\n\n```bash\nwhich flutter_beautify\ndart pub global deactivate flutter_beautify\n# can also delete project using path\nrm -rf path_of_project\n```\n\n---\n\n## Quick Start Guide\n\n### Step 1: Initialize Configuration\n\nNavigate to your Flutter project and initialize Flutter Beautify:\n\n```bash\nflutter_beautify init\n```\n### Step 2: Add Your First Component\n\nAdd a button widget to your project:\n\n```bash\nflutter_beautify add button\n```\n\n### Step 3: Use in Your Application\n\n```dart\n// lib/main.dart\nimport 'package:flutter/material.dart';\nimport 'package:my_flutter_app/widgets/button.dart';\n\nvoid main() {\n  runApp(const MyApp());\n}\n\nclass MyApp extends StatelessWidget {\n  const MyApp({Key? key}) : super(key: key);\n\n  @override\n  Widget build(BuildContext context) {\n    return MaterialApp(\n      home: Scaffold(\n        appBar: AppBar(title: const Text('Flutter Beautify Demo')),\n        body: Center(\n          child: FBButton.solid(\n            label: 'Click Me',\n            onPressed: () =\u003e print('Button tapped!'),\n          ),\n        ),\n      ),\n    );\n  }\n}\n```\n---\n\n## CLI Commands Reference\n\n### 1. `flutter_beautify init`\n\nInitialize Flutter Beautify configuration for your project.\n\n**Syntax:**\n```bash\nflutter_beautify init\n```\n\n**Use Cases:**\n- ✅ First-time setup\n- ✅ Custom project structure\n- ✅ Team standardization\n\n---\n\n### 2. `flutter_beautify config`\n\nDisplay the current Flutter Beautify configuration.\n\n**Syntax:**\n```bash\nflutter_beautify config\n```\n\n**Description:**\nReads and displays the current configuration from `.flutter_beautify_config.json`. If file doesn't exist, shows default values.\n\n**Use Cases:**\n- ✅ Verify configuration settings\n- ✅ Check project structure\n- ✅ Team alignment\n\n---\n\n### 3. `flutter_beautify add \u003ccomponent\u003e`\n\nAdd a component to your project.\n\n**Syntax:**\n```bash\nflutter_beautify add \u003ccomponent_name\u003e\n```\n\n**Parameters:**\n\n| Parameter | Required | Type | Description |\n|-----------|----------|------|-------------|\n| `\u003ccomponent_name\u003e` | ✅ Yes | string | Name of the component to add |\n\n**Example Usage:**\n\n```bash\n# Add a single component\nflutter_beautify add button\n\n# Add multiple components sequentially\nflutter_beautify add checkbox\nflutter_beautify add textfield\nflutter_beautify add card\n```\n\n**Supported Component Commands:**\n\n```bash\n# Input Components\nflutter_beautify add button          # Action button\nflutter_beautify add checkbox        # Checkbox input\nflutter_beautify add textfield       # Text input field\nflutter_beautify add radio-button    # Radio button group\nflutter_beautify add slider          # Slider control\nflutter_beautify add switch          # Toggle switch\nflutter_beautify add dropdown        # Dropdown select\n\n# Display Components\nflutter_beautify add card            # Card container\nflutter_beautify add badge           # Status badge\nflutter_beautify add avatar          # User avatar\nflutter_beautify add tooltip         # Tooltip overlay\nflutter_beautify add breadcrumb      # Breadcrumb trail\nflutter_beautify add appbar          # Custom app bar\nflutter_beautify add divider         # Visual divider\n\n# Progress \u0026 Status\nflutter_beautify add circular-progress    # Circular progress\nflutter_beautify add linear-progress      # Progress bar\nflutter_beautify add skeleton             # Loading skeleton\n\n# Navigation\nflutter_beautify add tabs                      # Tab navigation\nflutter_beautify add pagination               # Page navigation\nflutter_beautify add bottom-navigation-bar    # Bottom nav\nflutter_beautify add sidebar                  # Side navigation\n\n# Modals \u0026 Overlays\nflutter_beautify add dialog             # Dialog modal\nflutter_beautify add bottom-sheet       # Bottom sheet\nflutter_beautify add snackbar           # Snackbar notification\nflutter_beautify add toast              # Toast notification\n\n# Date \u0026 Time\nflutter_beautify add date-picker    # Date picker\nflutter_beautify add calendar       # Calendar widget\n\n# Special\nflutter_beautify add accordion      # Accordion component\n```\n\n---\n\n## Component Catalog\n\n### Overview\n\nFlutter Beautify provides **26 production-ready components** organized into 7 categories.\n\n### Complete Component List\n\n#### **Input Components** (7 widgets)\n\n| Component | Command | Factory Methods | Description |\n|-----------|---------|-----------------|-------------|\n| **Button** | `add button` | `.solid()` `.outline()` `.link()` | Action buttons with multiple styles |\n| **Checkbox** | `add checkbox` | `.standard()` `.outlined()` | Checkbox input with validation |\n| **TextField** | `add textfield` | `.outline()` `.filled()` `.underline()` | Text input with variants |\n| **RadioButton** | `add radio-button` | `.standard()` `.card()` | Radio button groups |\n| **Slider** | `add slider` | `.standard()` `.range()` | Range slider input |\n| **Switch** | `add switch` | `.standard()` `.outlined()` | Toggle switch control |\n| **Dropdown** | `add dropdown` | `.standard()` `.outlined()` | Dropdown menu select |\n\n#### **Display Components** (7 widgets)\n\n| Component | Command | Factory Methods | Description |\n|-----------|---------|-----------------|-------------|\n| **Card** | `add card` | `.elevated()` `.outlined()` `.flat()` | Container with styling |\n| **Badge** | `add badge` | `.standard()` `.small()` `.large()` `.outlined()` | Status/label badges |\n| **Avatar** | `add avatar` | `.circular()` `.square()` `.rounded()` | User profile avatars |\n| **Tooltip** | `add tooltip` | `.standard()` `.dark()` | Hover information overlay |\n| **Breadcrumb** | `add breadcrumb` | `.standard()` `.arrow()` | Navigation breadcrumb trail |\n| **AppBar** | `add appbar` | `.standard()` `.transparent()` `.gradient()` | Custom app bar |\n| **Divider** | `add divider` | `.horizontal()` `.vertical()` | Visual dividers |\n\n#### **Progress \u0026 Status** (3 widgets)\n\n| Component | Command | Factory Methods | Description |\n|-----------|---------|-----------------|-------------|\n| **CircularProgress** | `add circular-progress` | `.standard()` `.withLabel()` `.spinner()` | Circular progress indicator |\n| **LinearProgress** | `add linear-progress` | `.standard()` `.withLabel()` `.striped()` | Horizontal progress bar |\n| **Skeleton** | `add skeleton` | `.text()` `.image()` `.card()` | Loading skeleton screens |\n\n#### **Navigation Components** (4 widgets)\n\n| Component | Command | Factory Methods | Description |\n|-----------|---------|-----------------|-------------|\n| **Tabs** | `add tabs` | `.standard()` `.scrollable()` | Tab navigation |\n| **Pagination** | `add pagination` | `.standard()` `.minimal()` | Page navigation |\n| **BottomNavigationBar** | `add bottom-navigation-bar` | `.standard()` `.elevated()` | Bottom navigation |\n| **Sidebar** | `add sidebar` | `.standard()` `.dark()` `.collapsible()` | Side navigation panel |\n\n#### **Modal \u0026 Overlay** (4 widgets)\n\n| Component | Command | Factory Methods | Description |\n|-----------|---------|-----------------|-------------|\n| **Dialog** | `add dialog` | `.alert()` `.confirmation()` `.custom()` | Modal dialogs |\n| **BottomSheet** | `add bottom-sheet` | `.standard()` `.scrollable()` `.fullscreen()` | Bottom sheet modals |\n| **Snackbar** | `add snackbar` | `.info()` `.success()` `.error()` `.warning()` | Snackbar notifications |\n| **Toast** | `add toast` | `.short()` `.long()` `.custom()` | Toast notifications |\n\n#### **Date \u0026 Time** (2 widgets)\n\n| Component | Command | Factory Methods | Description |\n|-----------|---------|-----------------|-------------|\n| **DatePicker** | `add date-picker` | `.standard()` `.range()` | Date selection picker |\n| **Calendar** | `add calendar` | `.standard()` `.range()` | Interactive calendar widget |\n\n#### **Special Components** (1 widget)\n\n| Component | Command | Factory Methods | Description |\n|-----------|---------|-----------------|-------------|\n| **Accordion** | `add accordion` | `.standard()` `.outlined()` | Expandable accordion items |\n\n---\n\n## 📞 Support\n\n- **📖 Documentation**: [GitHub Wiki](https://github.com/DeveloperRejaul/flutter_beautify/wiki)\n- **🐛 Issues**: [GitHub Issues](https://github.com/DeveloperRejaul/flutter_beautify/issues)\n- **💬 Discussions**: [GitHub Discussions](https://github.com/DeveloperRejaul/flutter_beautify/discussions)\n- **📧 Email**: [Contact Developer](mailto:rejaul.pro@gmail.com)\n\n---\n\n## 🙌 Acknowledgments\n\n- Built with ❤️ using [Dart](https://dart.dev) and [Flutter](https://flutter.dev)\n- Inspired by [Material Design 3](https://m3.material.io/)\n- Thanks to the Flutter community for feedback and contributions\n\n---\n\n## 🔗 Quick Links\n\n### 📚 Documentation\n- **[CONTRIBUTING.md](CONTRIBUTING.md)** - How to contribute to the project\n- **[CONTACT.md](CONTACT.md)** - Contact information and support channels\n- **[PUB_DEV_SETUP.md](PUB_DEV_SETUP.md)** - Pub.dev publishing guide\n- **[GITHUB_ACTIONS_SETUP.md](GITHUB_ACTIONS_SETUP.md)** - GitHub Actions automation\n- **[CHANGELOG.md](CHANGELOG.md)** - Version history and updates\n\n### 🤝 Community\n- **[GitHub Issues](https://github.com/DeveloperRejaul/flutter_beautify/issues)** - Report bugs or request features\n- **[GitHub Discussions](https://github.com/DeveloperRejaul/flutter_beautify/discussions)** - Ask questions and discuss ideas\n- **[GitHub Repository](https://github.com/DeveloperRejaul/flutter_beautify)** - View source code\n\n### 📞 Get Help\n- **[CONTACT.md](CONTACT.md)** - For support and contact information\n- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Development setup and guidelines\n- **README.md** - Main documentation (you are here!)\n\n---\n\n## 📊 Statistics\n\n- **26** Production-Ready Components\n- **60+** Factory Method Variants\n- **20+** Demo Examples\n- **100%** Dart Code Coverage (widgets)\n- **Active** Maintenance \u0026 Support\n\n---\n\n**Made with ❤️ by [DeveloperRejaul](https://github.com/DeveloperRejaul)**\n\n**⭐ If you find this useful, please consider giving it a star on GitHub!**\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveloperrejaul%2Fflutter_beautify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeveloperrejaul%2Fflutter_beautify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveloperrejaul%2Fflutter_beautify/lists"}