A simple real-time messaging app built with Flutter, Firebase (Auth, Cloud Firestore) and Supabase (Edge Functions, Database) - designed for a single purpose: let people reach you directly from your personal website.

No need to share social media links. No need for third-party contact forms.
Just embed Talkest on your website, and anyone with a Google account can start a conversation with you instantly.

Why does this exist?
I built Talkest because I wanted a simple "get in touch" solution for my portfolio website. Instead of redirecting visitors to social media, they can just chat with me right there, powered by a Flutter Web widget embedded directly into the page.

• Real-time messaging — Powered by Cloud Firestore with live message streaming
• Google Sign-In — One-tap authentication, no extra account needed
• Light & Dark theme — With system theme detection and manual toggle
• QR Code profile — Each user gets a personal QR code for quick contact sharing
• QR Scanner — Scan someone's QR code to start a chat instantly
• Start chat by email — Find and message any registered user by their email address
• Editable display name — Customize how your name appears to others
• Embeddable chat widget — Deploy the Flutter Web build and embed it on any website via iframe
• Native mobile app — Install the Android app to monitor and reply to incoming messages on the go
• Push Notifications — High-priority alerts with heads-up display, custom sounds, and auto-dismissal when chat is read.
• Deep Linking — Clicking a notification takes you directly to the relevant chat room.

Login	Chat List	Messaging

Embed mode — Landing page on portfolio website

Embed mode — Chat view on portfolio website

• Flutter SDK
• Firebase project with Authentication and Cloud Firestore enabled
• Google OAuth 2.0 Client ID (for Flutter Web only)

Collections and documents are created automatically when the app runs for the first time — no manual setup needed. Below is the database structure for reference:

├── app_users (collection) │ └── {uid} (document) │ ├── name: string │ ├── displayName: string │ ├── email: string │ ├── photoUrl: string │ ├── provider: string │ ├── createdAt: timestamp │ ├── updatedAt: timestamp │ └── lastLoginAt: timestamp │ └── chats (collection) └── {chatId} (document) ├── type: string ("direct") ├── participants: array [uid1, uid2] ├── createdAt: timestamp ├── updatedAt: timestamp ├── unreadCount: map { uid1: number, uid2: number } ├── lastMessage: map │ ├── id: string │ ├── senderId: string │ ├── text: string │ ├── type: string │ ├── createdAt: timestamp │ └── isDeleted: boolean │ └── 📁 messages (subcollection) └── {messageId} (document) ├── id: string ├── chatId: string ├── senderId: string ├── type: string ├── text: string ├── createdAt: timestamp ├── editedAt: timestamp (optional) ├── isDeleted: boolean ├── replyToId: string (optional) ├── replyToSenderId: string (optional) ├── replyToSenderName: string (optional) └── replyToText: string (optional) 

Security rules are defined in firestore.rules.

This project requires a composite index for querying chats. The index configuration is defined in firestore.indexes.json.

Deploy both rules and indexes at once:

firebase deploy --only firestore --project YOUR_PROJECT_ID

Or deploy them individually if needed:

firebase deploy --only firestore:rules --project YOUR_PROJECT_ID firebase deploy --only firestore:indexes --project YOUR_PROJECT_ID

1. Via Firebase Console (Recommended):

   • Open Firebase Console
   • Select your project → Project Settings
   • Add a Web app (if not already added)
   • The Client ID will be auto-generated in Google Cloud Console

2. Manual Setup:

   • Go to Google Cloud Console
   • Navigate to APIs & Services → Credentials
   • Create OAuth client ID → Select Web application
   • Configure:
     • Authorized JavaScript origins:
       • http://localhost
       • http://localhost:5000
       • https://your-domain.firebaseapp.com (production)
     • Authorized redirect URIs:
       • https://your-domain.firebaseapp.com/__/auth/handler
   • Copy the generated Client ID

The profiles table in Supabase is used to sync FCM tokens for notification delivery:

create table profiles ( id uuid references auth.users on delete cascade, email text unique, fcm_token text, updated_at timestamp with time zone, primary key (id) );

Talkest uses Supabase Edge Functions to trigger FCM v1.

1. Service Account: Place your Firebase Service Account JSON in the Edge Function environment.
2. Environment Variables: Set up the following in your Supabase project:
   • FIREBASE_SERVICE_ACCOUNT: Your JSON key.
3. Deployment:

   supabase functions deploy send-notification

Web (Development):

flutter run -d chrome \ --dart-define=GOOGLE_WEB_CLIENT_ID=YOUR_CLIENT_ID.apps.googleusercontent.com \ --dart-define=SUPABASE_ANON_KEY=YOUR_SUPABASE_ANON_KEY

Mobile (Android/iOS):

flutter run -d <device-id> \ --dart-define=SUPABASE_ANON_KEY=YOUR_SUPABASE_KEY

Web (Release)

flutter build web --release \ --dart-define=GOOGLE_WEB_CLIENT_ID=YOUR_WEB_ID.apps.googleusercontent.com \ --dart-define=SUPABASE_ANON_KEY=YOUR_SUPABASE_KEY

Mobile (Release)

flutter build --release \ --dart-define=SUPABASE_ANON_KEY=YOUR_SUPABASE_KEY

Talkest supports an embedded chat widget mode, designed to be loaded inside an <iframe> on any website. This allows visitors to chat with a specific user directly from your page.

URL format:

https://your-talkest-deployment.com/?embed=1&targetUid=FIREBASE_USER_UID 

Example iframe usage:

<iframe src="https://khip01.github.io/talkest/?embed=1&targetUid=YOUR_FIREBASE_UID" width="400" height="600" style="border: none; border-radius: 12px;" allow="clipboard-read; clipboard-write" ></iframe>

Parameters:

In embed mode, the app will:

• Show a landing page with a sign-in prompt for unauthenticated visitors
• Automatically open a direct chat with the target user after sign-in
• Hide navigation elements like the FAB and profile access for a clean widget experience

• Flutter Documentation
• Firebase Setup Guide
• Google Sign-In for Flutter

Made with 🤍 by Khip01