Less Is More: Engineering Challenges of On-Device Small Language Model Integration in a Mobile Application

TL;DR

This paper examines the engineering challenges of integrating small language models into mobile apps, highlighting failure categories, mitigation strategies, and practical heuristics for reliable on-device AI experiences.

Contribution

It provides a detailed case study of on-device SLM integration in a mobile game, identifying failure modes and proposing effective engineering solutions.

Findings

On-device SLMs can be used in production with careful engineering.

Mitigation strategies include defensive parsing and fallback mechanisms.

The most reliable feature is when the LLM generates minimal output.

Abstract

On-device Small Language Models (SLMs) promise fully offline, private AI experiences for mobile users (no cloud dependency, no data leaving the device). But is this promise achievable in practice? This paper presents a longitudinal practitioner case study documenting the engineering challenges of integrating SLMs (Gemma 4 E2B, 2.6B parameters; Qwen3 0.6B, 600M parameters) into Palabrita, a production Android word-guessing game. Over a 5-day development sprint comprising 204 commits (~90 directly AI-related), the system underwent a radical transformation: from an ambitious design where the LLM generated complete structured puzzles (word, category, difficulty, and five hints as JSON) to a pragmatic architecture where curated word lists provide the words and the LLM generates only three short hints, with a deterministic fallback if it fails. We identify five categories of failures specific to on-device SLM integration: output format violations, constraint violations, context quality degradation, latency incompatibility, and model selection instability. For each failure category, we document the observed symptoms, root causes, and the prompt engineering and architectural strategies that effectively mitigated them, including multi-layer defensive parsing, contextual retry with failure feedback, session rotation, progressive prompt hardening, and systematic responsibility reduction. Our findings demonstrate that on-device SLMs are viable for production mobile applications, but only when the developer accepts a fundamental constraint: the most reliable on-device LLM feature is one where the LLM does the least. We distill our experience into eight actionable design heuristics for practitioners integrating SLMs into mobile apps.