tawakkalna_sdk_flutter 0.0.5-alpha.5
tawakkalna_sdk_flutter: ^0.0.5-alpha.5 copied to clipboard
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.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