zeba_academy_spacing 1.0.0

A Flutter spacing utility package providing gap widgets, margin helpers, padding helpers and spacing extensions.

Changelog

All notable changes to this project will be documented in this file.

The format follows Keep a Changelog principles.

This project follows Semantic Versioning.

---

1.0.0 - 2026-07-10

Added

Gap Widgets

• Added ZebaGap widget for creating equal width and height spacing.
• Added ZebaHorizontalGap widget for horizontal spacing.
• Added ZebaVerticalGap widget for vertical spacing.

Example:

ZebaVerticalGap(20);

---

Margin Helpers

Added widget extension helpers for easier margin management.

New APIs:

• .margin()
• .marginOnly()
• .marginSymmetric()

Features:

• Apply margins directly on widgets.
• Supports individual edge customization.
• Reduces repetitive Container margin code.

---

Padding Helpers

Added widget extension helpers for cleaner padding implementation.

New APIs:

• .padding()
• .paddingOnly()
• .paddingSymmetric()

Features:

• Simple widget-level padding.
• Supports custom edge padding.
• Improves widget readability.

---

Spacing Extensions

Added number-based spacing extensions.

New APIs:

• .verticalSpace
• .horizontalSpace
• .gap

Examples:

16.verticalSpace

12.horizontalSpace

Features:

• Fast spacing creation.
• Cleaner UI layouts.
• Less boilerplate code.

---

Spacing Constants

Added predefined spacing values.

Available constants:

• ZebaSpacing.xs
• ZebaSpacing.sm
• ZebaSpacing.md
• ZebaSpacing.lg
• ZebaSpacing.xl
• ZebaSpacing.xxl

Features:

• Encourages consistent design systems.
• Helps maintain UI spacing standards.

---

Developer Experience

Added:

• Null-safe Dart implementation.
• Clean public API exports.
• Organized package structure.
• Flutter widget extension support.
• Documentation comments.
• Unit tests for core functionality.

---

Testing

Added initial test coverage for:

• Gap widgets.
• Spacing extensions.
• Package exports.

Verified with:

flutter analyze

and:

flutter test

---

Documentation

Added:

• Complete README documentation.
• Installation instructions.
• Usage examples.
• API explanations.
• GPL-3.0 licensing information.

---

Future Roadmap

Planned improvements:

Upcoming Features

• Responsive spacing utilities.
• Screen-size based spacing.
• Adaptive spacing helpers.
• Layout spacing presets.
• Design system integration.
• More Flutter UI productivity utilities.

---

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

See the LICENSE file for more information.

---

Maintainer

Sufyan bin Uzayr

Open-source developer building reusable Flutter packages and developer tools.

Website:

https://sufyanism.com/

Zeba Academy:

https://zeba.academy/

---

Thank you for using zeba_academy_spacing ❤️