flutter_bangla_math 0.4.1

Render mixed Bangla text and LaTeX math in Flutter without breaking Bengali glyph shaping.

flutter_bangla_math

flutter_bangla_math renders mixed Bangla text and LaTeX math in Flutter without breaking Bengali glyph shaping. It uses flutter_math_fork for TeX rendering and bundles Noto Sans Bengali so it works offline on Android, iOS, web, Linux, macOS, and Windows.

Features

• Inline math with $...$
• Block math with $$...$$
• Fraction layout with BanglaMathFraction
• Inline \bnfrac{...}{...} syntax inside BanglaMathText
• Escaped dollar handling with \$
• Bangla text rendered with bundled Noto Sans Bengali by default
• Inline math baseline alignment tuned for mixed Bangla and math on the same line
• Offline-safe bundled font loading with no runtime font fetching dependency

Installation

dependencies:
  flutter_bangla_math: ^0.4.1

The current package targets Flutter >=3.16.0 and Dart >=3.2.0 <4.0.0.

Usage

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

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ensureBanglaMathFontsLoaded();
  runApp(const DemoApp());
}

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

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: Scaffold(
        body: Padding(
          padding: EdgeInsets.all(24),
          child: BanglaMathText(
            data: 'যদি $a^2+b^2=c^2$ হয়, তবে এটি সমকোণী ত্রিভুজ।',
          ),
        ),
      ),
    );
  }
}

Block Math

const BanglaMathText(
  data: 'সমীকরণটি হল:\n\n$$\\int_0^1 x^2\\,dx=\\frac{1}{3}$$',
);

Bangla Fraction

const BanglaMathFraction(
  numerator: r'লব $x+1$',
  denominator: r'হর $y+2$',
  style: TextStyle(fontSize: 20),
);

Inline Fraction Syntax

const BanglaMathText(
  data: r'যদি $a^2+b^2=c^2$ হয়, তবে \bnfrac{লব $x+1$}{হর $y+2$} হবে।',
);

Custom Text Style

const BanglaMathText(
  data: 'ধরি $f(x)=x^2+1$',
  style: TextStyle(fontSize: 20, color: Colors.black87),
);

API

BanglaMathText({
  required String data,
  TextStyle? style,
  MathConfig? mathConfig,
  String? fontFamily,
  Locale locale = const Locale('bn'),
  TextAlign textAlign = TextAlign.start,
  bool softWrap = true,
  TextScaler? textScaler,
  MathWidgetCache? cache,
})

BanglaMathFraction({
  required String numerator,
  required String denominator,
  TextStyle? style,
  MathConfig? mathConfig,
  String? fontFamily,
  Locale locale = const Locale('bn'),
  TextAlign textAlign = TextAlign.center,
  bool softWrap = true,
  TextScaler? textScaler,
  MathWidgetCache? cache,
  Color? barColor,
  double barThickness = 1,
  double gap = 4,
  EdgeInsetsGeometry padding = const EdgeInsets.symmetric(horizontal: 4),
})

MathConfig controls inline scaling, block spacing, parser settings, and error fallback styling. BanglaMathFraction reuses the same text and math pipeline, so numerator and denominator strings can contain Bangla text with inline math. BanglaMathText also supports inline \bnfrac{...}{...} tokens in normal paragraph text.

Notes

• Unmatched $ or $$ delimiters fall back to plain text instead of crashing.
• The package bundles only Noto Sans Bengali to keep size lower.
• ensureBanglaMathFontsLoaded() is still available and preloads the bundled font.
• The Noto Sans Bengali OFL text remains in the repository for reference, but it is not bundled into runtime Flutter assets.

Development

flutter pub get
flutter analyze
flutter test