Wivora | Flutter AI Assistant App Template

Wivora is a production-ready Flutter AI assistant app template — streaming chat, image generation, a persona library and multi-session history, built on a bring-your-own-key multi-provider layer (OpenAI, Claude, Gemini). It runs out of the box in Demo Mode, with no API key and no backend of your own required.

Wivora ships a distinctive, dark-first design system — a deep-graphite theme, an electric cyan → violet “AI” gradient on every hero moment, Sora + Manrope typography and a tight, technical layout. Every token is centralized, so you can re-skin the entire app from one color file.

Unlike a static UI kit, Wivora is functional — a real streaming pipeline and a provider abstraction you connect to your own AI accounts:

• Streaming chat — Server-Sent-Events streamed token by token behind a live cursor, a dependency-free Markdown renderer (headings, lists, bold/italic/code and fenced code blocks with a language label and a Copy button), and a send ↔ stop control.
• Bring your own key — OpenAI, Claude and Gemini behind one LlmProvider interface, each a thin pure-http SSE client (deliberately no vendor SDKs, so you are never locked to a package’s release cadence). Keys are stored in the platform keychain/keystore and never logged.
• Demo Mode — with no key configured, a mock provider streams a canned reply and image generation returns a branded gradient placeholder, so the whole app is demonstrable at zero API cost.
• Persona library & Image Studio — 10 preset assistants that seed a system prompt when you start a chat, plus a prompt-driven image Studio with aspect chips and a generated gallery.

Built for developers:

• Clean GetX architecture (View → Controller → Service → Provider, lazy bindings per route)
• One provider interface with four implementations — add your own by implementing LlmProvider
• Hand-written SSE parsing in one small file — adapt to any API change without touching a dependency
• Reusable, theme-aware components; a monetization scaffold (paywall UI + ad-banner slot) ready to wire to RevenueCat / AdMob

What you get: full Flutter source code, a README with re-theming & provider-integration notes, offline HTML documentation (every screen, a feature walkthrough, a providers & API-keys guide, a Demo Mode guide, a logo & brand-color guide, an app-name & bundle-ID guide, environment setup and a troubleshooting section), a mock data layer, and light + dark themes.

Requirements: To run and build the source code you need the Flutter SDK (version 3.29 or newer) and Dart 3.7 or newer, together with a Flutter-ready IDE — Android Studio or Visual Studio Code with the Flutter & Dart plugins. Dependencies are limited to get, google_fonts, http and flutter_secure_storage.

Platforms: Runs on both Android and iOS from a single Flutter codebase (Material 3, null-safe).

Important note on third-party AI services & external costs: Wivora ships with no bundled API keys and does not proxy or resell any AI service. To use live responses you must supply your own API key for each provider (OpenAI, Anthropic/Claude, Google/Gemini). Those providers will bill you directly for usage under their own pricing, and connecting any other back end (analytics, storage, push, etc.) will involve those third-party services, which will incur their own separate costs — none of which are included in this item. The bundled Demo Mode incurs no cost.