Geramy Loveless 713743c671 Merge pull request #38 from lemonade-sdk/fix/review-round3
Review round 3: invite code, join errors, chip contrast
2026-11-19 19:42:49 -08:00
2026-10-01 10:57:48 -07:00
2026-09-16 07:40:31 -07:00
2026-01-04 18:34:42 -07:00
2026-01-08 10:11:03 -05:00
2026-11-13 13:47:42 -08:00
2026-02-27 15:39:55 -08:00

🍋 Lemonade Mobile: local AI server companion app

Lemonade Chat Screenshot 1 Lemonade Chat Screenshot 2 Lemonade Chat Screenshot 3 Lemonade Chat Screenshot 4

iPhone/iPad | Android | Discord

Lemonade Mobile is a polished chat interface for Lemonade AI servers with syntax highlighting and multi-server support. Start your server, connect this app, and take your Lemonade to go.

A Lemonade Open Source Project - maintained by Geramy Loveless.

Features

  • Multi-Server Support: Connect to multiple Lemonade/OpenAI-compatible servers
  • Code Syntax Highlighting: Beautiful code rendering with language detection
  • Streaming Responses: Real-time chat with live text streaming
  • Dark Theme: Modern dark UI that's easy on the eyes
  • Persistent Chat History: Never lose your conversations
  • Cross-Platform: Works on mobile and desktop

Quick Start

# Get dependencies
flutter pub get

# Run the app
flutter run

Configuration

Adding AI Servers

  1. Launch the app and tap the settings gear icon
  2. Add your server details:
    • Name: Something descriptive like "My Local Server"
    • URL: Your server endpoint (e.g., http://192.168.1.10:8000/api) - Later will be changed to be user friendly.
    • API Key: Optional, defaults to "lemonade" if empty

Testing Connections

Use the checkmark button next to each server to verify connectivity before chatting.

How to Use

  • Server Selection: Pick your AI server from the top dropdown
  • Model Selection: Expand the drawer menu to choose different models
  • Chat Interface:
    • Type your message and hit send
    • Watch responses stream in real-time
    • Code blocks get automatic syntax highlighting
  • Copy Functions:
    • Long-press any message to copy it entirely
    • Tap the copy icon on code blocks to copy just that code
  • Chat Management:
    • Create new conversations from the drawer
    • Switch between chat threads
    • Delete old conversations you don't need

Tech Stack

  • Framework: Flutter with Material Design 3
  • State Management: Riverpod for clean architecture
  • Persistence: SharedPreferences for local storage
  • API Integration: dart_openai for OpenAI-compatible endpoints
  • UI Polish: Custom themes and smooth animations

Project Layout

lib/
├── main.dart                 # App bootstrap & routing
├── models/                   # Data structures
│   ├── server_config.dart    # Server connection details
│   ├── chat_message.dart     # Message format
│   └── chat_history.dart     # Conversation management
├── providers/                # State management
│   ├── servers_provider.dart # Server list & selection
│   ├── chat_provider.dart    # Active conversation
│   ├── chat_history_provider.dart # Saved conversations
│   └── models_provider.dart  # Available AI models
├── screens/                  # Main UI screens
│   ├── chat_screen.dart      # Main chat interface
│   └── settings_screen.dart  # Server configuration
├── services/                 # External integrations
│   └── openai_service.dart   # AI API communication
├── widgets/                  # Reusable UI components
│   ├── chat_input.dart       # Message composition
│   ├── message_bubble.dart   # Message display with code highlighting
│   ├── server_selector.dart  # Server picker
│   └── chat_drawer.dart      # Navigation sidebar
└── utils/                    # Shared utilities
    └── constants.dart        # Theme & styling constants

This project is licensed as MIT

S
Description
Community maintained mobile app for use with Lemonade. Join our discord: https://discord.gg/5xXzkMu8Zk
Readme MIT
148 MiB
0 Stars 1 Watchers 0 Forks
v3.0.3
Latest
2026-11-21 05:01:59 -10:00
Languages
Dart 94.9%
C++ 1.7%
CMake 1.3%
Swift 0.6%
Shell 0.4%
Other 1%