Skip to main content

appforge 0.6.0 copy "appforge: ^0.6.0" to clipboard
appforge: ^0.6.0 copied to clipboard

A zero-dependency, all-in-one Flutter micro-framework providing reactive state, context-free navigation, BiDi Arabic localization, responsive scaling, and storage.

example/lib/main.dart

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

import 'translations.dart';
import 'controllers/app_settings_controller.dart';
import 'controllers/state_lab_controller.dart';
import 'controllers/lifecycle_lab_controller.dart';
import 'screens/home_screen.dart';

/// Example byte-level codec demonstrating optional encryption at rest via
/// [AppStorageCodec] without adding external dependencies.
class _ExampleStorageCodec extends AppStorageCodec {
  const _ExampleStorageCodec();

  @override
  List<int> encode(List<int> bytes) => <int>[for (final b in bytes) b ^ 0x5A];

  @override
  List<int> decode(List<int> bytes) => <int>[for (final b in bytes) b ^ 0x5A];
}

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // Initialize zero-dependency AppStorage engine with optional encryption codec
  // and observable error handler (no silent catch blocks or temp fallback).
  await App.initStorage(
    codec: const _ExampleStorageCodec(),
    onError: (error, stackTrace, context) {
      debugPrint('[AppForge Storage] $context: $error');
    },
  );

  // Load zero-dependency Environment Configuration from .env file
  await App.loadEnv(fileName: '.env', isOptional: true);

  // Register Tier-0 core controllers into AppForge service locator
  App.put(AppSettingsController(), permanent: true);
  App.put(StateLabController(), permanent: true);
  App.put(LifecycleLabController(), permanent: true);

  // Single zero-boilerplate root widget replacing nested MaterialApp boilerplate
  runApp(
    MasterApp(
      title: 'AppForge Showcase',
      home: const HomeScreen(),
      translations: DemoAppTranslations(),
      initialLocale: const Locale('ar'),
      fallbackLocale: const Locale('en', 'US'),
      persistLocale: true,
      persistTheme: true,
      harmonizeTheme: true,
      designSize: const Size(390, 844),
      theme: ThemeData(
        useMaterial3: true,
        brightness: Brightness.light,
        colorScheme: ColorScheme.fromSeed(
          seedColor: const Color(0xFF041C4E),
          primary: const Color(0xFF041C4E),
          secondary: const Color(0xFFC99A3D),
          brightness: Brightness.light,
        ),
        scaffoldBackgroundColor: const Color(0xFFF8FAFC),
        cardColor: Colors.white,
      ),
      // darkTheme is intentionally omitted so AppThemeHarmonizer automatically
      // derives a matching, WCAG AA contrast-safe dark theme!
    ),
  );
}
1
likes
150
points
1.23k
downloads
screenshot

Documentation

API reference

Publisher

verified publisherbechattaoui.dev

Weekly Downloads

A zero-dependency, all-in-one Flutter micro-framework providing reactive state, context-free navigation, BiDi Arabic localization, responsive scaling, and storage.

Repository (GitHub)
View/report issues

Topics

#state-management #navigation #localization #responsive #storage

Funding

Consider supporting this project:

github.com
ko-fi.com

License

MIT (license)

Dependencies

flutter

More

Packages that depend on appforge