Search packages, repositories and app categories

circular_bottom_navigation cover
Package detailsv2.4.0

circular_bottom_navigation

Circular Bottom Navigation (or maybe a tab bar)

AndroidiOSWebmacOSWindowsLinux
30-day downloads
592
Likes
223
Pub points
130

Install package

flutter pub add circular_bottom_navigation

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A circular bottom navigation widget for Flutter that offers a modern, visually appealing alternative to traditional tab bars. It supports smooth animations and customizable icons, labels, and colors. Designed for use across multiple platforms including Android, iOS, Web, macOS, Windows, and Linux, it provides a consistent user experience. The package is lightweight and easy to integrate, making it ideal for apps seeking a unique navigation layout without sacrificing functionality.

Use cases

  • Mobile app navigation
  • Web application interfaces
  • Cross-platform UI design
  • Modern app aesthetics
  • Custom tab bar implementation

Key features

  • Circular layout design
  • Smooth animation transitions
  • Customizable icons and labels
  • Multi-platform support
  • Easy integration with Flutter
  • Configurable color schemes

Suitable for

  • Developers seeking unique navigation patterns
  • Apps with limited screen space
  • Design-focused applications
  • Cross-platform projects
  • UI/UX experimentation

Considerations

  • May require additional styling for accessibility
  • Limited to circular layout (not linear)
  • Potential learning curve for customization
  • Not suitable for complex navigation hierarchies
  • Depends on external GitHub repository for updates

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Circular Bottom Navigation (or maybe a tab bar).

Awesome Flutter

pub package APK

This is implementation of an artwork in Uplabs

Let's get started

1 - Install and import

In your Dart code, you can use:
import 'package:circular_bottom_navigation/circular_bottom_navigation.dart';
import 'package:circular_bottom_navigation/tab_item.dart';

2 - CheatSheet

3 - Use it like a charm

Make your TabItems
List<TabItem> tabItems = List.of([
    TabItem(Icons.home, "Home", Colors.blue, labelStyle: TextStyle(fontWeight: FontWeight.normal)),
    TabItem(Icons.search, "Search", Colors.orange, labelStyle: TextStyle(color: Colors.red, fontWeight: FontWeight.bold)),
    TabItem(Icons.layers, "Reports", Colors.red, circleStrokeColor: Colors.black),
    TabItem(Icons.notifications, "Notifications", Colors.cyan),
  ]);
Use this widget everywhere you want
CircularBottomNavigation(
      tabItems,
      selectedCallback: (int selectedPos) {
        print("clicked on $selectedPos");
      },
    )

CircularBottomNavigation supports RTL designs, If you wrap your widget in a Directionality widget and set the textDirection property you can customize the direction:

MaterialApp(
  title: 'Circular Bottom Navigation Demo',
  theme: ThemeData(
    primarySwatch: Colors.blue,
  ),
  home: Directionality(
    // use this property to change direction in whole app
    // CircularBottomNavigation will act accordingly
    textDirection: TextDirection.rtl,
    child: MyHomePage(title: 'circular_bottom_navigation'),
  ),
);
How to use CircularBottomNavigationController

With this controller you can read the current tab position, and set a tab position on widget (without needing to rebuild the tree) with the widget built in animation.

Just create a new instance of controller

CircularBottomNavigationController _navigationController =
new CircularBottomNavigationController(selectedPos);

Then pass it in your widget

CircularBottomNavigation(
      tabItems,
      controller: _navigationController,
    );

Now you can write (set new position with animation) and read value from it everywhere you want

// Write a new value
_navigationController.value = 0;

// Read the latest value
int latest = _navigationController.value;

Categories

Source repository

Projects using this package

No data available yet.