tawakkalna_sdk_flutter 0.0.5-alpha.5 copy "tawakkalna_sdk_flutter: ^0.0.5-alpha.5" to clipboard
tawakkalna_sdk_flutter: ^0.0.5-alpha.5 copied to clipboard

Platformweb

Flutter SDK for Tawakkalna - Saudi Arabia's super app. Access government services, user data, and documents seamlessly in alignment with Vision 2030.

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.0.5-alpha.5 - 2025-11-23 #

Added #

  • Comprehensive "Building for Tawakkalna Release" section in README with step-by-step deployment guide
  • Automated release script (scripts/release.sh) for building and packaging mini apps
  • Instructions for removing <base href> tag from index.html for Tawakkalna compatibility
  • Bundle size optimization guide (CanvasKit removal)
  • Pre-deployment checklist for Tawakkalna submissions

Changed #

  • Improved README structure with dedicated deployment section
  • Fixed emoji rendering issues in README (Unicode escape sequences to actual emojis)
  • Enhanced production build workflow with cleanup steps for unnecessary mock files

Fixed #

  • README emoji display issues in browsers (๐Ÿงช, ๐Ÿšฆ, ๐Ÿš€, ๐Ÿ“, ๐Ÿงต, ๐Ÿ”ง, ๐Ÿชต, ๐Ÿ“‹, ๐Ÿ“ˆ, ๐Ÿ”, ๐Ÿ’พ, ๐Ÿ”‡, ๐Ÿ“ฑ)

0.0.3-alpha.4 - 2025-11-20 #

Changed #

  • Remove the debug banner in example app
  • Screenshots in README

0.0.3-alpha.3 - 2025-11-20 #

Changed #

  • Enhanced package description with more detail about mini apps and SDK capabilities
  • Updated README with screenshots section showcasing example app on different platforms

0.0.1-alpha.2 - 2025-11-20 #

Changed #

  • Updated README with current implementation status for all API methods
  • Shortened package description to meet pub.dev requirements (180 char max)

0.0.1-alpha.1 - 2025-11-19 #

Added #

Core Features

  • Initial release of Tawakkalna SDK for Flutter
  • Support for V1 API with 50+ methods covering:
    • Personal information (ID, name, gender, birth date, nationality, contact)
    • Documents (passports, ID expiry, document numbers, Iqama)
    • Health data (blood type, health status, disability information)
    • Family & sponsors with filtering capabilities
    • Vehicles and traffic violations (paid/unpaid)
    • Location services (GPS and national addresses)
    • Education & career information
    • Gallery, camera, and file management
    • Permissions management (location, camera, gallery, notifications)
    • Authentication (biometric)
    • QR/Barcode scanner
    • Device information
  • Support for V2 API with 5 methods:
    • Token generation
    • User full name (bilingual)
    • User nationality (bilingual with ISO code)
    • Family members (with filtering)
    • Sponsors (with filtering)

Development Tools

  • Mock/Demo implementation with realistic Saudi Arabian test data
  • Built-in logger with UI integration and memory management
  • Comprehensive example app with 50+ interactive API demos
  • Type-safe Dart models for all data structures
  • Strongly-typed enums for gender, user types, blood types, etc.
  • JavaScript interop for Flutter Web (primary target platform)
  • Mock and production JavaScript bridge files

Platform Support

  • Web (primary target for Tawakkalna mini apps)
  • Android, iOS (for testing with mock data)
  • macOS, Windows, Linux (for development/testing)

Documentation

  • Comprehensive README with API examples
  • Developer guide with best practices
  • Troubleshooting section
  • Links to official Tawakkalna developer documentation
  • Complete API methods checklist with implementation status

Example App

  • Interactive demo with 50+ API examples
  • Organized sections matching README API Methods Checklist structure
  • Real-time results display with error handling
  • Integrated logger with statistics and filtering

Notes #

  • This is an unofficial SDK maintained by individual contributors
  • Real data access only available when running inside the official Tawakkalna mobile app
  • Designed for building mini apps (HTML/JS) using Flutter Web
  • All platforms support mock data for development and testing
4
likes
160
points
29
downloads
screenshot

Publisher

verified publisherbalsm.health

Weekly Downloads

Flutter SDK for Tawakkalna - Saudi Arabia's super app. Access government services, user data, and documents seamlessly in alignment with Vision 2030.

Repository (GitHub)
View/report issues

Topics

#tawakkalna #sdk #saudi-arabia #government-services #ksa

Documentation

API reference

License

MIT (license)

Dependencies

equatable, flutter

More

Packages that depend on tawakkalna_sdk_flutter