# win32_runner

**Repository Path**: mick-zeng/win32_runner

## Basic Information

- **Project Name**: win32_runner
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![ci][ci_badge]][ci_link]
[![Package: win32_runner][package_badge]][package_link]
[![Publisher: halildurmus.dev][publisher_badge]][publisher_link]
[![Language: Dart][language_badge]][language_link]
[![License: BSD-3-Clause][license_badge]][license_link]

**A Dart runner for Flutter Windows apps — no C++ compiler required.**

`package:win32_runner` is an *experimental* package that replaces the default
C++ runner generated by `flutter create` with a pure Dart alternative, letting
you build and run Flutter Windows apps without a C++ toolchain installed.

> ⚠️ **Experimental:** This package is a proof-of-concept and is **not suitable
> for production use**. Plugin support is not yet implemented.

## 🚀 Getting Started

The [example] subdirectory contains a ready-to-use sample. Follow the steps
below to run an existing Flutter app on Windows using the Dart runner.

**1. Clone the repository**

```console
C:\src> git clone https://github.com/halildurmus/win32_runner.git
C:\src> cd win32_runner
```

**2. Install dependencies**

```console
C:\src\win32_runner> dart pub get
```

**3. Create a sample Flutter app**

```console
C:\src\win32_runner> cd ..
C:\src> flutter create simpleapp
C:\src> cd simpleapp
```

**4. Compile the Dart runner**

```console
C:\src\simpleapp> dart build cli -t ..\win32_runner\example\win32_runner.dart -o build
```

**5. Compile Flutter code and assets**

```console
C:\src\simpleapp> flutter assemble -dTargetPlatform=windows-x64 --output=build -dBuildMode=release release_bundle_windows-x64_assets
```

**6. Run your Flutter app**

```console
C:\src\simpleapp> .\build\bundle\bin\win32_runner.exe
```

You should now see your Flutter app running via the Dart runner:

![demo][demo_image_link]

## 📝 Documentation

Full API reference is available here:

👉 [API Reference][api_reference_link].

Additional usage examples are located in the [example] directory.

## 🐞 Features and Bugs

If you encounter bugs or need additional functionality, please
[file an issue][issue_tracker_link].

[api_reference_link]: https://pub.dev/documentation/win32_runner/latest/
[ci_badge]: https://github.com/halildurmus/win32_runner/actions/workflows/win32_runner.yml/badge.svg
[ci_link]: https://github.com/halildurmus/win32_runner/actions/workflows/win32_runner.yml
[demo_image_link]: https://raw.githubusercontent.com/halildurmus/win32_runner/main/screenshots/demo.png
[example]: https://github.com/halildurmus/win32_runner/tree/main/example
[issue_tracker_link]: https://github.com/halildurmus/win32_runner/issues
[language_badge]: https://img.shields.io/badge/language-Dart-blue.svg
[language_link]: https://dart.dev
[license_badge]: https://img.shields.io/github/license/halildurmus/win32_runner?color=blue
[license_link]: https://opensource.org/licenses/BSD-3-Clause
[package_badge]: https://img.shields.io/pub/v/win32_runner.svg
[package_link]: https://pub.dev/packages/win32_runner
[publisher_badge]: https://img.shields.io/pub/publisher/win32_runner.svg
[publisher_link]: https://pub.dev/publishers/halildurmus.dev