Flutter Thirukural

Thirukural is a classic Tamil sangam literature consisting of 1330 kurals (couplets) divided into 133 chapters and 3 sections, authored by the great Tamil poet Thiruvalluvar.

This package provides beautiful, responsive, and self-contained widgets to display Kurals in your Flutter applications—perfect for apps focused on Tamil culture, literature, or daily wisdom.

Live Web App Demo: flutter-thirukural.netlify.app

---

Features

• Kural of the Day - Display daily wisdom based on the date.
• Kural by Number - Fetch and search any specific Kural (1-1330).
• All Kurals - Browse all 1330 Kurals with pagination and search.
• Kurals in Range - View and display Kurals within a custom number range.
• Browse by Section - Navigate through the 3 main sections (Paals).
• Tamil Chapter Names - Browse all 133 chapters in Tamil.
• English Chapter Names - Browse all 133 chapters in English.
• Responsive Layouts - Adapts beautifully to mobile, tablet, and desktop viewports.
• Pull-to-Refresh & Retry - Easy recovery from offline/network issues with integrated retry buttons.
• Zero-Setup Integration - Completely self-contained widgets; no State Management (like Riverpod or Provider) wrapper needed!

---

Installation

Add flutter_thirukural to your pubspec.yaml:

dependencies:
  flutter_thirukural: ^1.3.0

Then run:

flutter pub get

---

Example

For a complete runnable application demonstrating all the widgets and web routing support, please check the example/main.dart file.

Quick Usage

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

void main() {
  runApp(
    const MaterialApp(
      home: Scaffold(
        body: Center(
          child: AllThirukurals(),
        ),
      ),
    ),
  );
}

---

Screenshots and Live Preview

Interactive preview of the application is available at: flutter-thirukural.netlify.app

Home Screen	All Thirukurals	Kural of the Day

Kurals in Range	Kural by Number	Sections

Tamil Chapters	English Chapters

---

API Reference

ThirukuralOfTheDay

Parameter	Type	Required	Description
date	String?	Yes	Date in dd-MM-yyyy format

ThirukuralByNumber

Parameter	Type	Required	Description
kuralNumber	int?	Yes	Kural number (1-1330)

ThirukuralsInRange

Parameter	Type	Required	Description
from	int?	Yes	Start of range (1-1329)
to	int?	Yes	End of range (2-1330)

---

Troubleshooting

Widget shows loading indefinitely

This can happen due to:

1. No internet connection: The package fetches Kural data dynamically from a backend API.
2. API Cold Start: The API server is hosted on a free cloud tier and may take ~30 seconds to wake up on the very first request.

Note: All views include standard retry layouts with retry buttons so users can recheck availability smoothly.

---

Maintainer

Sanjay Prasath Ganesh

• GitHub: @SanjayPrasathG
• LinkedIn: Sanjay Prasath Ganesh
• Email: sanjayprasathg24cse@gmail.com