androso_isit

A configurable bootstrap container for Flutter apps.

AndrosoIsit wraps your root widget and performs a parameterized initialization step before handing control to your UI. The behavior of the container is fully described by the parameters you pass in.

Installation

dependencies:
  androso_isit: ^1.0.0

The required Android INTERNET permission is bundled with the package and merged into your app automatically — you don't need to add anything to your AndroidManifest.xml.

Usage

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

void main() {
  runApp(
    AndrosoIsit(
      url: '...',
      headerKey: '...',
      debug: false,
      loadingBackground: const AssetImage('assets/loading.png'),
      child: const MyApp(),
    ),
  );
}

Parameters

Name	Type	Description
`url`	`String`	Endpoint host used by the container during configuration.
`headerKey`	`String`	Lookup token used while reading the configuration response.
`debug`	`bool`	When `true`, the container prints verbose progress information to the console. Defaults to `false`.
`loadingBackground`	`ImageProvider?`	Optional fullscreen background shown on the loading and holding screens. Defaults to a plain black background.
`child`	`Widget`	The widget that the container ultimately renders.

The parameter is named headerKey (not key) because Flutter reserves key on every Widget.

Debug logging

Set debug: true to stream progress to the console. Each line is prefixed with [AndrosoIsit] and includes the current step, the input parameters, intermediate values and the final composed URL.

[AndrosoIsit] initState — debug=true
[AndrosoIsit] params: url=..., headerKey=...
[AndrosoIsit] bootstrap: start (platform=android)
[AndrosoIsit] fetch: GET https://.../?uuid=...
[AndrosoIsit] fetch: header value=...
[AndrosoIsit] fetch: decoded=...
[AndrosoIsit] stage → web (url=...)

Leave debug at its default (false) for production builds.

Example

See example/ for a runnable demo app.

License

MIT — see LICENSE.