Flutter Bullet Dots

A simple Flutter package for customizable bullet dots and lists with various shapes and styles.

Features

🎯 Multiple bullet shapes (circle, square, diamond, triangle, star, hexagon)
🎨 Customizable colors, sizes, and borders
📝 Simple bullet lists with text
🔧 Custom bullet lists with any widget content
📱 Easy to use and integrate

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_bullet_dots: ^1.0.0

Usage

Basic Bullet Dot

import 'package:flutter_bullet_dots/flutter_bullet_dots.dart';

// Simple circular bullet dot
BulletDot(
  size: 8.0,
  color: Colors.blue,
  shape: BulletShape.circle,
)

Different Shapes

// Circle (default)
BulletDot(shape: BulletShape.circle)

// Square
BulletDot(shape: BulletShape.square)

// Diamond
BulletDot(shape: BulletShape.diamond)

// Triangle
BulletDot(shape: BulletShape.triangle)

// Star
BulletDot(shape: BulletShape.star)

// Hexagon
BulletDot(shape: BulletShape.hexagon)

Customized Bullet Dot

BulletDot(
  size: 12.0,
  color: Colors.red,
  shape: BulletShape.square,
  borderRadius: 8.0,
  borderColor: Colors.black,
  borderWidth: 2.0,
)

Simple Bullet List

BulletList(
  items: [
    'First item',
    'Second item',
    'Third item',
  ],
  bulletDot: BulletDot(
    color: Colors.green,
    shape: BulletShape.star,
  ),
  spacing: 8.0,
  itemSpacing: 4.0,
  textStyle: TextStyle(fontSize: 16),
)

Custom Bullet List

CustomBulletList(
  items: [
    BulletListItem(
      bulletDot: BulletDot(
        color: Colors.blue,
        shape: BulletShape.circle,
      ),
      child: Text('Item with custom bullet'),
    ),
    BulletListItem(
      bulletDot: BulletDot(
        color: Colors.red,
        shape: BulletShape.star,
      ),
      child: Row(
        children: [
          Icon(Icons.check),
          SizedBox(width: 8),
          Text('Item with icon'),
        ],
      ),
    ),
  ],
)

API Reference

BulletDot

Property	Type	Default	Description
`size`	`double`	`8.0`	Size of the bullet dot
`color`	`Color`	`Colors.blue`	Color of the bullet dot
`shape`	`BulletShape`	`BulletShape.circle`	Shape of the bullet dot
`borderRadius`	`double`	`4.0`	Border radius for rounded shapes
`borderColor`	`Color?`	`null`	Border color
`borderWidth`	`double`	`0.0`	Border width

BulletShape

circle - Circular bullet dot
square - Square bullet dot
diamond - Diamond-shaped bullet dot
triangle - Triangle-shaped bullet dot
star - Star icon bullet dot
hexagon - Hexagon-shaped bullet dot

BulletList

Property	Type	Default	Description
`items`	`List<String>`	Required	List of text items
`bulletDot`	`BulletDot`	`BulletDot()`	Bullet dot style
`spacing`	`double`	`8.0`	Spacing between bullet and text
`itemSpacing`	`double`	`4.0`	Spacing between list items
`textStyle`	`TextStyle?`	`null`	Text style for items
`alignment`	`CrossAxisAlignment`	`CrossAxisAlignment.start`	Alignment of bullet dots

CustomBulletList

Property	Type	Default	Description
`items`	`List<BulletListItem>`	Required	List of bullet list items
`spacing`	`double`	`8.0`	Spacing between bullet and content
`itemSpacing`	`double`	`4.0`	Spacing between list items
`alignment`	`CrossAxisAlignment`	`CrossAxisAlignment.start`	Alignment of bullet dots

BulletListItem

Property	Type	Description
`bulletDot`	`BulletDot`	Bullet dot for this item
`child`	`Widget`	Content of this item

Example

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

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Bullet Dots Example')),
      body: Padding(
        padding: EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text('Simple Bullet List:', style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold)),
            SizedBox(height: 8),
            BulletList(
              items: ['Feature 1', 'Feature 2', 'Feature 3'],
              bulletDot: BulletDot(color: Colors.blue, shape: BulletShape.circle),
            ),
            SizedBox(height: 24),
            Text('Custom Bullet List:', style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold)),
            SizedBox(height: 8),
            CustomBulletList(
              items: [
                BulletListItem(
                  bulletDot: BulletDot(color: Colors.green, shape: BulletShape.star),
                  child: Text('Important item'),
                ),
                BulletListItem(
                  bulletDot: BulletDot(color: Colors.orange, shape: BulletShape.triangle),
                  child: Text('Warning item'),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.