Alpi

🚀 Alpi is a lightweight Flutter helper package designed to speed up your UI development.

With just a few lines, you get powerful shortcuts for MediaQuery sizing, effortless Padding, handy SizedBox spacers, and quick Text styling — making your Flutter code cleaner and faster to write.

Features

🔹 Screen sizing helpers

Use the Alpi class to quickly calculate fractions of screen width and height. A MediaQuery alternative!

Alpi.width(context, 0.25); // 25% of parent's width

Alpi.height(context, 0.50); // 50% of parent's height

---

🔹 EasyPadding

Simplify Padding widgets with clear constructors:

// Equal padding on all sides
EasyPadding.all(12, child: Text("All sides = 12"))

// Different padding for each side
EasyPadding.only(top: 8, bottom: 6, child: Text("Top 8, Bottom 6"))

// Symmetric padding
EasyPadding.symmetric(vertical: 10, horizontal: 20, child: Text("Vertical 10, Horizontal 20"))

---

🔹 SizedBox helpers

Shorthand for spacing or wrapping children with fixed width/height.

// Height-only spacer
SizedBoxHeight(20)

// Width-only spacer
SizedBoxWidth(16)

// With child
SizedBoxHeight(40, child: Text("Inside SizedBox"))

---

🔹 Text helpers

Quickly render bold or italic text without writing styles each time.

ItalicText("This is italic text")

BoldText("This is bold text")

// With custom style (overrides defaults)

BoldText("Custom bold text",style: TextStyle(color: Colors.red, fontSize: 20),)

---

🔹 ColorUtils

ColorUtils lets you convert HEX codes directly to a Color.

// Basic 6-digit hex
ColorUtils.fromHex('#FF5733')


// Hex without '#'
ColorUtils.fromHex('3498db')

  
// With alpha channel (80 = 50% opacity)
ColorUtils.fromHex('#803498db')

  
// Get a random RGB color
ColorUtils.random()

---

🔹 ColorExtensions

Extensions that add convenient methods directly on Flutter's Color class.

// Convert this Color to hex string
someColor.toHex(someColor)

// 10% darker
Colors.orange.darken()

// 25% darker
Colors.orange.darken(0.25)

// 10% lighter
Colors.green.lighten()

// 40% lighter
Colors.green.lighten(0.4)

---

🔹 Console.writeLine

An alternative to Flutter's debugPrint(), inspired from C#!

// Basic log
Console.writeLine("Button tapped");

// Log variables
Console.writeLine("User ID: $userId");

// Log JSON or objects
Console.writeLine("Response: ${jsonEncode(response)}");

---

🔹 FormValidator

Easily validate any form.

// 1. Basic usage
validator: (value) => FormValidator.required(value);

// 2. Custom field name
validator: (value) =>
  FormValidator.required(value, fieldName: "Email");

// 3. Custom message
validator: (value) =>
  FormValidator.required(
    value,
    fieldName: "Password",
    cantBeEmptyMessage: "is required!",
  );

---

Getting started

Add alpi as a dependency in your pubspec.yaml:

dependencies:

alpi: ^0.0.2+1

Then import it in your Dart code:

import  'package:alpi/alpi.dart';

---

Usage example

Here’s a minimal example of using Alpi in a widget tree:

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

class DemoPage extends StatelessWidget {
  const DemoPage({super.key});

  @override
  Widget build(BuildContext context) {
    Console.writeLine('Hello world!');
    
    return Scaffold(
      appBar: AppBar(title: const Text("Alpi Demo")),
      body: Center(
        child: EasyPadding.all(
          16,
          child: Column(
            mainAxisSize: MainAxisSize.min,
            children: [
              const BoldText("Hello Alpi!"),
              const SizedBoxHeight(12),
              const ItalicText("This text is italic."),
              const SizedBoxHeight(20),
              Container(
                width: Alpi.width(context, 0.5), // 50% of parent's width
                height: Alpi.height(context, 0.2), // 20% of parent's height
                color: ColorUtils.fromHex("#1565c0"),
                alignment: Alignment.center,
                child: const BoldText("Responsive box"),
              ),
              const SizedBoxHeight(20),
              EasyPadding.symmetric(
                vertical: 8,
                horizontal: 16,
                child: Container(
                  color: Colors.green,
                  child: const ItalicText("Padded text with EasyPadding"),
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}