Project Pol v3.0 - FFI Architecture

A Single-Process Decentralized Package Manager Bridge for Flutter

Pol converts pub.dev dependencies to Git-based dependencies - all in one desktop app with native performance.

Architecture

+-------------------------------------------+
|            Flutter Desktop App            |
|                                           |
|  +---------------+    +---------------+   |
|  | UI (Flutter)  |<-->| Business Logic|   |
|  +---------------+    |   (Dart)      |   |
|                       +-------+-------+   |
|                               |           |
|                           FFI |           |
|                               v           |
|                       +---------------+   |
|                       | dart_engine   |   |
|                       |   (Rust DLL)  |   |
|                       +---------------+   |
+-------------------------------------------+

Layer	Technology	Purpose
UI	Flutter	Windows desktop interface
Logic	Dart	YAML parsing, GitHub API, orchestration
Native	Rust (DLL)	Fast Git operations via FFI

Quick Start

1. Build Native Library

.\scripts\build.ps1

This will:

• Build the Rust DLL
• Copy it to the Flutter project

2. Run the App

cd frontend
flutter run -d windows

Project Structure

pol/
├── engines/
│   └── dart_engine/          # Rust FFI library
│       ├── Cargo.toml
│       └── src/lib.rs        # C-compatible exports
│
├── frontend/                  # Flutter Desktop App
│   ├── lib/
│   │   ├── core/
│   │   │   ├── ffi/          # Dart FFI bindings
│   │   │   ├── services/     # YAML, GitHub, Converter
│   │   │   └── ...
│   │   └── features/
│   │       ├── dependency_list/
│   │       ├── converter/
│   │       └── logs/
│   └── windows/
│       └── runner/
│           └── dart_engine.dll  # Native library
│
└── scripts/
    └── build.ps1             # Build script

Features

• Single Process: No separate backend to run
• Native Performance: Git operations via Rust FFI
• Auto Resolution: Finds GitHub repos for pub.dev packages
• Monorepo Support: Correctly handles multi-package repos
• Backup: Creates backup before modifying pubspec.yaml

Prerequisites

• Rust (1.70+): https://rustup.rs/
• Flutter (3.0+): https://flutter.dev/
• Windows 10/11

GitHub Token (Optional)

For higher API rate limits, set your token in the app settings.

License

MIT License