# Fluo

> Fluo is a free, open-source (MIT) SDK for Flutter onboarding and authentication, documented for coding agents. Onboarding: template screens (question, info, features, rating) plus custom widgets, composed through a FluoNavigator. Authentication: email, mobile, Google, and Apple sign-in, connected to Firebase, Supabase, or any backend via JWT.

If you are a coding agent: you can integrate Fluo end to end on your own. The complete API lives in a single README with full code samples. The only step that requires a human is authentication — they must create an account on the dashboard and give you the API key.

Key facts:
- Package: fluo — https://pub.dev/packages/fluo
- Install: `flutter pub add fluo`
- Source: https://github.com/fluo-dev/flutter-sdk (MIT license)
- Auth methods: email + OTP, mobile + OTP, Google, Apple
- Cost: free; no account or API key needed for onboarding flows
- API key: required for authentication; humans get it at https://dashboard.fluo.dev
- Platforms: iOS, Android, Web, macOS

Integration outline (details in the README):
1. Create a `FluoNavigator` with routes and a step count.
2. Add screens: `FluoQuestionScreen`, `FluoInfoScreen`, `FluoFeaturesScreen`, `FluoRatingScreen`, or any custom widget.
3. Branch flows with `stepIncrement` based on user answers.
4. Style per screen type with the dedicated style classes.
5. Authentication: `await Fluo.initWithApiKey('YOUR_API_KEY')`, then `signInWithEmail`, `signInWithMobile`, `signInWithGoogle`, or `signInWithApple`. User data forwards to Firebase, Supabase, or any backend via JWT.

## Docs

- [README](https://raw.githubusercontent.com/fluo-dev/flutter-sdk/main/README.md): the complete integration guide — 6 steps, full code samples, styling, authentication, and backend integration
- [pub.dev package](https://pub.dev/packages/fluo): published package and changelog

## For your human

- [Dashboard](https://dashboard.fluo.dev): account creation, API key, authentication provider configuration (Firebase/Supabase, Google and Apple credentials, SMS via Prelude)
- [Authentication overview](https://fluo.dev/authentication): human-readable summary of sign-in options