patch_pal

Description:

patch pal

PatchPal #

patch_pal is a Flutter package that enables you to easily enable or disable features in your app by utilizing a JSON configuration file. You can use either a Gist or a raw Git JSON file.
Table of Contents #

Getting Started
JSON Structure
Usage
TODO List

Getting Started #
Before you begin, make sure you have a JSON configuration file prepared. The JSON structure should look like this:
{
"packageName": "com.yeasin50.patch_pal",
"version": "1.0.0",
"items": [
{
"name": "number of mango",
"value": 3,
"message": "added 3 mangos"
},
{
"name": "rain",
"value": true,
"message": "enabled rain based on weather"
}
],
"updates": ["looking for updates..."]
}
copied to clipboard
Usage #
Follow these steps to integrate patch_pal into your Flutter project:
Step 1: Add Dependency #
Add patch_pal as a dependency in your pubspec.yaml file:
dependencies:
patch_pal: ^1.0.0 # Latest version
copied to clipboard
Alternatively, if you want to use the latest from the repository, use:
patch_pal:
git:
url: https://github.com/yeasin50/patch_pal.git
ref: master
copied to clipboard
Step 2: Import the Package #
Import the package in your Dart code:
import 'package:patch_pal/patch_pal.dart';
copied to clipboard
Step 3: Initialize the Configuration #
Initialize the path to your JSON configuration file using PatchPal.init(yourJsonConfigFilePath);. You can use a FutureBuilder to set up the path asynchronously. The yourJsonConfigFilePath should return a valid JSON file.
Step 4: Access Values #
You can access values using the PatchItemName. Here are some common use cases:

To show a dialog, use PatchPal.dialog.
Replace a widget with a patcher view using PatchPal.view.
Show overlays or stack widgets based on value using PatchPal.overlay.
Switch between widgets based on the value using PatchPal.switcher.

TODO List #

❌ Config (JSON) generator
✅ Alert widgets and views
❌ Stream or ValueListenable support

License #
This project is licensed under the MIT License - see the LICENSE.md file for details.