Skip to main content
DESKTOP VIEWPORT REQUIRED1024px+

"the admin is fu*ked up making the site responsive for mobile, please open the site on a desktop -thank you"

No desktop setup? Consider this alternative:

Mobile Client · AI CompanionFlutter · FastAPI · Supabase · TTS

A customized, friendly personal AI companion mobile app built with Flutter and Dart, powered by a FastAPI backend and Supabase for persistent conversation ledgers.

Lumina AI Mobile Application mockups

Client
Lumina AIPersonal AI project
Year
2024Cross-Platform Mobile
Role
Lead DeveloperFull-Stack AI Architect
Stack
FastAPI · Supabase (Postgres)Flutter Client · Google OAuth
Status
LiveHosted on Render/Supabase

Most AI assistants are designed to be transactional and formal. Lumina was engineered to act as an immersive text-messaging friend, capable of emotional empathy, humor, and personal memory.

Upon first startup, users undergo a gamified personality onboarding assessment. This designs the AI companion's tone, boundary rules, and speech patterns (e.g. conversational, formal, casual).

The app integrates Supabase Session Ledgers to write and read message history permanently, combined with FastAPI and JWT tokens for secure authentication.

Vision

Companion AI,
tailored for empathy.

To build a chatbot that feels like a real texting partner. Lumina adapts its conversational pacing and remembers details from past discussions to bring continuity.

Equipped with built-in voice rendering (TTS), letting users hear spoken responses matching the companion's assigned mood.

Product

Glassmorphic UI,
uncompromising responsiveness.

Features an edge-to-edge chat window with glowing glassmorphic panels, ambient message arrival transitions, and real-time typing indicators.

Connections are guarded by network listeners, displaying a smooth fallback sheet when internet connection drops and syncing database buffers upon restoration.

LUMINA system diagram overview
LUMINA full system architecture overview.
Telemetry

Interactive 3 companion UI.

01Personality Assessment onboardingDemonstrating the Personality Assessment onboarding functionality built into the core stack.Empathy config
02Glassmorphic Chat WindowDemonstrating the Glassmorphic Chat Window functionality built into the core stack.Dynamic bubbles
03Voice dictation interfaceDemonstrating the Voice dictation interface functionality built into the core stack.Speech to Text
Architecture

FastAPI server
Supabase ledger integration.

Lumina separates client UI logic from AI model routing and Postgres storage, hosting a scalable API backend on Render.

Mobile Frontend
  • Flutter SDK
  • Dio API Client
  • Google Sign-In

Cross-platform mobile client handling user session tokens, audio recording, and rendering the custom chat bubble animations.

Server & database
  • FastAPI
  • Uvicorn
  • Supabase
  • PostgreSQL

Modular routers handling JWT validation, onboarding profiles, conversation history ledger writes, and LLM orchestration.

100%OAuth SecurityGoogle Sign-In authorization
<100msDB Fetch SpeedPostgreSQL index queries
FastAPIAPI EngineUvicorn parallel routing
Outcomes

Texting redesigned,
continuity preserved.

99.9%Auth uptimeSecured session management via Supabase
Colophon

Engineered by byteWizard-zero.

Full-Stack Architecture & API
Zenith Soumya
AI & Mobile Specialist
About Z.S

Zenith Soumya is an AI Developer and mobile app specialist who focuses on building human-centric conversational interfaces.

Lumina's backend is hosted live on Render, communicating with Supabase PostgreSQL clusters.

Download APK ↗All workBack home