zeba_academy_layout_debugger 0.0.1 copy "zeba_academy_layout_debugger: ^0.0.1" to clipboard
zeba_academy_layout_debugger: ^0.0.1 copied to clipboard

Visual layout debugging tool for Flutter (padding, overflow, alignment, inspector)

zeba_academy_layout_debugger #

πŸš€ A powerful visual layout debugging tool for Flutter that helps you understand widget structure in real time.


✨ Features #

  • 🎯 Visualize padding & spacing
  • 🚨 Detect overflow issues instantly
  • πŸ“ Highlight alignment problems
  • πŸ” Built-in tap inspector (live coordinates)
  • ⚑ Lightweight & zero dependencies

πŸ“Έ Preview #

Add screenshots/gifs here to showcase debugging overlays


πŸš€ Getting Started #

1. Add Dependency #

dependencies:
  zeba_academy_layout_debugger:
    path: ../

2. Import #

import 'package:zeba_academy_layout_debugger/zeba_academy_layout_debugger.dart';

3. Usage #

LayoutDebugger(
  padding: const EdgeInsets.all(16),
  config: const DebugConfig(
    showPadding: true,
    detectOverflow: true,
    enableInspector: true,
  ),
  child: Container(
    padding: const EdgeInsets.all(20),
    color: Colors.green,
    child: const Text("Hello Debugger"),
  ),
)

βš™οΈ Configuration #

DebugConfig(
  showPadding: true,
  showMargins: true,
  detectOverflow: true,
  highlightAlignment: true,
  enableInspector: true,
)
Property Description
showPadding Highlights padding visually
showMargins (Future support) margin visualization
detectOverflow Shows overflow warnings
highlightAlignment Detects alignment issues
enableInspector Enables tap inspector

πŸ§ͺ Example Use Cases #

  • Debugging complex UI layouts
  • Fixing overflow errors quickly
  • Understanding spacing issues
  • Teaching Flutter layout concepts

⚠️ Important Notes #

  • Use only in debug mode
  • Avoid enabling in production builds
if (kReleaseMode) return child;

πŸ›£οΈ Roadmap #

  • πŸ”Ή Margin visualization
  • πŸ”Ή Widget tree inspector panel
  • πŸ”Ή DevTools integration
  • πŸ”Ή Alignment heatmaps

🀝 Contributing #

Contributions are welcome! Feel free to open issues or submit pull requests.


πŸ“„ License #

This project is licensed under the GNU General Public License v3.0.


πŸ‘¨β€πŸ’» About Me #

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects. You can learn more about me and my work at sufyanism.com or connect with me on Linkedin


🌐 Your all-in-one no-bloat hub! #

πŸš€ Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy. Empower yourself with practical skills through curated directives, real-world projects, and hands-on experience. Level up your tech game today! πŸ’»βœ¨

Zeba Academy is a learning platform dedicated to coding, technology, and development. ➑ Visit our main site: zeba.academy ➑ Explore hands-on courses and resources at: code.zeba.academy ➑ Check out our YouTube for more tutorials: zeba.academy ➑ Follow us on Instagram: zeba.academy


⭐ If you like this package, don’t forget to star the repo!

0
likes
140
points
--
downloads

Documentation

API reference

Publisher

verified publisherzeba.academy

Weekly Downloads

Visual layout debugging tool for Flutter (padding, overflow, alignment, inspector)

Homepage

License

GPL-3.0 (license)

Dependencies

flutter

More

Packages that depend on zeba_academy_layout_debugger