What is luaviewsdk?

alibaba/luaviewsdk — explained in plain English

Analysis updated 2026-07-03

★ 3,724Objective-CAudience · developerComplexity · 4/5LicenseSetup · hard

Mindmap

mindmap
  root((luaviewsdk))
    What it does
      Dynamic UI updates
      Shared Lua codebase
      No app release needed
    Tech Stack
      Lua scripting engine
      iOS Objective-C
      Android Java
    Use Cases
      Commerce pages
      In-app games
      Dynamic layouts
    Audience
      Mobile developers
      iOS and Android teams

mindmap root((luaviewsdk)) What it does Dynamic UI updates Shared Lua codebase No app release needed Tech Stack Lua scripting engine iOS Objective-C Android Java Use Cases Commerce pages In-app games Dynamic layouts Audience Mobile developers iOS and Android teams

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Build a shopping app page that updates instantly without pushing a new app store release by swapping out its Lua script.

USE CASE 2

Share one UI codebase between your iOS and Android apps using Lua scripts instead of maintaining two separate native implementations.

USE CASE 3

Embed a small Lua-powered game or promotional screen inside an existing mobile app with minimal memory overhead.

USE CASE 4

Dynamically change the layout of a commerce page at runtime by pushing a new Lua file to your app users.

What is it built with?

LuaObjective-CiOSAndroidJava

How does it compare?

	alibaba/luaviewsdk	sbjson/sbjson	tombenner/nui
Stars	3,724	3,718	3,737
Language	Objective-C	Objective-C	Objective-C
Setup difficulty	hard	easy	easy
Complexity	4/5	2/5	2/5
Audience	developer	developer	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires setting up both iOS and Android native build environments and embedding the Lua VM into your existing project.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

So what is it?

LuaViewSDK is a framework from Alibaba's Tmall team that lets developers build native mobile app pages for both iOS and Android using a single shared codebase written in Lua, a lightweight scripting language. Rather than shipping a new app update every time a page design changes, teams can update the Lua scripts that control the UI, and those changes appear dynamically in the app. The framework targets mobile developers who are already familiar with native development. It presents an API that maps closely to how native iOS and Android components work, so there is no need to learn web concepts like React or the DOM. A single Lua virtual machine takes very little memory (around 200-300 kilobytes on iOS), making it practical to embed. The SDK has been used in Taobao, Tmall, and Juhuasuan, three large Alibaba shopping apps, with over 10 million daily active users on pages rendered through LuaViewSDK. Both complex commerce pages and simple games are shown as examples. A playground app is available for download on iOS and Android so developers can experiment without building anything. Documentation and an API reference are linked from the README. The project is released under the MIT open source license.

Copy-paste prompts

Prompt 1

I have an iOS app written in Objective-C. Show me how to embed LuaViewSDK and render a Lua-scripted product page without shipping a new App Store release.

Prompt 2

Write a Lua script for LuaViewSDK that creates a scrollable product list with an image, title, and buy button following the LuaViewSDK API conventions.

Prompt 3

How does LuaViewSDK pass data from native Objective-C code into a Lua view, and what is the recommended pattern for calling native callbacks from Lua?

Prompt 4

How do I set up a LuaViewSDK playground project on Android to test Lua UI scripts on an emulator without building a full production app?

Frequently asked questions