📊 nrb (Nexora Report Builder) #

A customizable and highly responsive Flutter table widget builder designed for complex, nested headers and dynamic data visualization. Ideal for enterprise dashboards, inventory tracking, financial reports, or structured data-entry UIs.

✨ Features #

• 📱 Fully Responsive: Columns auto-measure their content (wrap_content) and expand proportionally to fill available screen space.
• 📌 Complex Nested Headers: Build main headers, sub-headers, and sticky left-side columns (like Excel-style freeze panes).
• ✍️ Editable Data Grids: Mix static TextCells with interactive TextFieldCells to turn your report into a scrollable data-entry form.
• 🔄 Real-time Data Extraction: Use ReportController to extract all grid data instantly via a Submit action.
• 💰 Advanced Number Formatting: Built-in NRBNumberFormatter handles International and Indian comma separation, along with granular rounding rules.
• 📏 Resizable Columns: Double-click column edges to auto-fit, or drag to manually resize.
• 📥 Premium Export & Share: Instantly download tables to Excel, PDF, or Word, or share them directly via native device dialogs (Requires an active subscription bound to your App's Package Name).

🚀 Getting Started #

To integrate nrb into your Flutter project:

1. Add dependency #

dependencies:
  nrb: ^[latest_version]

2. Prepare main to include the report layout #

import 'dart:io';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:nrb/nrb.dart';

void main() {
  runApp(const MyReportBuilderApp());
}

class MyReportBuilderApp extends StatefulWidget {
  const MyReportBuilderApp({super.key});

  @override
  State<MyReportBuilderApp> createState() => _MyReportBuilderAppState();
}

class _MyReportBuilderAppState extends State<MyReportBuilderApp> {
  // 1. Initialize the controller to extract data later
  final ReportController _reportController = ReportController();

  final List<HeaderCell> headers = [
    HeaderCell(text: "Financial Overview", span: 3, backgroundColor: Colors.green),
  ];

  final List<SubHeaderCell> subHeaders = [
    SubHeaderCell(text: "Target", backgroundColor: Colors.green),
    SubHeaderCell(text: "Actual", backgroundColor: Colors.green),
    SubHeaderCell(text: "Growth %", backgroundColor: Colors.green),
  ];

  final leftColumns = [
    TextCell(itemContent: "Q1 - 2026", backgroundColor: Colors.blue[200], textColor: Colors.black),
    TextCell(itemContent: "Q2 - 2026", backgroundColor: Colors.blue[200], textColor: Colors.black),
  ];

  final tableData = [
    [
      TextCell(
        itemContent: "1500000",
        isAmount: true,
        numberFormatType: CellNumberFormat.indian,
        textAlignment: Alignment.centerRight,
      ),
      TextCell(
        itemContent: "1250000",
        isAmount: true,
        numberFormatType: CellNumberFormat.indian,
        textAlignment: Alignment.centerRight,
      ),
      // Editable Cell for user input
      TextFieldCell(initialValue: "83.33%"),
    ],
    [
      TextCell(
        itemContent: "2000000",
        isAmount: true,
        numberFormatType: CellNumberFormat.international,
        textAlignment: Alignment.centerRight,
      ),
      TextCell(
        itemContent: "1900000",
        isAmount: true,
        numberFormatType: CellNumberFormat.international,
        textAlignment: Alignment.centerRight,
      ),
      // Editable Cell for user input
      TextFieldCell(initialValue: "95.00%"),
    ],
  ];

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(primarySwatch: Colors.blue),
      home: Scaffold(
        appBar: AppBar(title: const Text('Enterprise Dashboard')),
        body: Column(
          children: [
            Expanded(
              child: ReportMaker(
                headers: headers,
                subHeaders: subHeaders,
                leftColumn: leftColumns,
                tableData: tableData,
                stickyHeaderLabel: "Quarter",
                stickyHeaderBackgroundColor: Colors.green,
                
                // --- NEW FEATURES OVERVIEW ---
                controller: _reportController, // Attach controller for data extraction
                enableDownload: true,          // Enable premium export
                showDownloadFloatingButton: true, // Render the interactive FAB
                packageName: "com.yourcompany.yourapp", // Your registered subscription package
                onDownloadCompleted: (bytes, fileName) async {
                  if (!kIsWeb) {
                    final directory = Directory('/storage/emulated/0/Download');
                    if (!await directory.exists()) await directory.create(recursive: true);
                    
                    final file = File('${directory.path}/$fileName');
                    await file.writeAsBytes(bytes);
                    if (kDebugMode) print('File saved to: ${file.path}');
                  }
                },
              ),
            ),
            Padding(
              padding: const EdgeInsets.all(8.0),
              child: ElevatedButton(
                onPressed: () {
                  // 2. Extract all current UI data instantly!
                  List<List<String>> finalData = _reportController.getSubmitData();
                  if (kDebugMode) print("Extracted Data: $finalData");
                },
                child: const Text("Submit Report Data"),
              ),
            )
          ],
        ),
      ),
    );
  }
}

🧮 Number Formatting #

nrb comes with a powerful formatter built directly into TextCell. Simply flag the cell as an amount and choose your style:

TextCell(
  itemContent: "1099493.5",
  isAmount: true, // Automatically applies commas
  numberFormatType: CellNumberFormat.indian, // Formats as 10,99,493.5
  roundMode: RoundMode.withRoundUp,
  roundTo: 2, // Formats as 10,99,493.50
  textAlignment: Alignment.centerRight,
)

Want to directly use on any part? Just follow the syntax below:

NRBNumberFormatter.format(yourAmountValue, style: NumberStyle.indian, roundTo: 2)

📥 Premium Export & Share Features (Subscription) #

nrb supports backend-driven exporting of your perfectly formatted grids to Excel (.xlsx), PDF, and Word, complete with an interactive floating action menu for downloading and sharing.

To enable the interactive download and share buttons in the UI:

1. Set enableDownload: true and showDownloadFloatingButton: true in ReportMaker.
2. Crucial: Provide your app's exact packageName. This package name must be registered and hold an active premium subscription.
3. Use the interactive FAB to either Download the file directly or Share it instantly via your device's native sharing dialog (e.g., email, messaging apps).
4. Handle the incoming bytes using the onDownloadCompleted callback if you need custom save logic.

👑 Get Premium: Access to the official Nexora API for file generation and sharing requires an active premium subscription tied to your application's package name.

👉 Purchase a Subscription at Innovate Nest Labs

📂 Example Output #

📄 License #

© 2026 Mehedi Hasan & Fahad Mia

This software is licensed under a custom license. Usage is permitted in personal and commercial projects, but:

• ❌ No redistribution or resale
• ❌ No modification of the source
• ✅ Attribution required

See the LICENSE file for full terms and conditions.

📬 Support & Contributions #

For issues, feature requests, or contributions, feel free to open a GitHub Issue.