# Guides

The guides are the "how do I build with this?" side of Plugin Kit.

The [concepts](https://plugin-kit.saad-ardati.dev/concepts/plugins/) explain what the runtime is and how it thinks. The guides show the moves you make on top of that: write a plugin, wire it into Flutter, configure it, log it, test it.

If you are looking for what `StatefulPluginService` or `Capability` or `ConfigNode` mean, you want concepts. If you are looking for how to add one to your app, you are in the right place.

## The useful path

1. **Write one plugin.**

   Start with [Adding a Plugin](https://plugin-kit.saad-ardati.dev/guides/adding-a-plugin/). It takes a feature and turns it into a plugin without drowning you in every advanced option.

2. **Wire it into Flutter.**

   Two pages, read together. [Migrating a Flutter App](https://plugin-kit.saad-ardati.dev/guides/migrating-flutter-app/) is the strategy: fitting Plugin Kit beside Provider, Riverpod, Bloc, GetIt, or existing managers without pretending to replace them. [Flutter Integration](https://plugin-kit.saad-ardati.dev/guides/flutter-integration/) is the concrete widget bridge: where the runtime lives, how widgets hear about plugin changes, and how plugin-provided UI is resolved.

3. **Configure it at runtime.**

   [Settings & Overrides](https://plugin-kit.saad-ardati.dev/guides/settings/) covers runtime enablement, priority overrides, wildcard overrides, and the live reconciliation that makes settings dialogs and customization panels feel responsive.

4. **Operate it.**

   [Logging](https://plugin-kit.saad-ardati.dev/guides/logging/) and [Testing](https://plugin-kit.saad-ardati.dev/guides/testing/) cover the boring production concerns that are only boring when they work.

## Start by what you are trying to do

[I want to write a plugin](https://plugin-kit.saad-ardati.dev/guides/adding-a-plugin/)
  [I need the Flutter widget bridge](https://plugin-kit.saad-ardati.dev/guides/flutter-integration/)
  [I want the Flutter bridge with less boilerplate](https://plugin-kit.saad-ardati.dev/guides/flutter-plugin-kit/)
  [I already have a Flutter app](https://plugin-kit.saad-ardati.dev/guides/migrating-flutter-app/)
  [I want library-specific bridge code](https://plugin-kit.saad-ardati.dev/reference/state-management-bridges/)
  [I need users to configure it](https://plugin-kit.saad-ardati.dev/guides/settings/)
  [I want a customization UI for free](https://plugin-kit.saad-ardati.dev/guides/plugin-kit-dialog/)
  [I need to test it](https://plugin-kit.saad-ardati.dev/guides/testing/)