We’re excited to announce a powerful new API method for developers: appConfig is now available in window.LIA_API. This update allows you to dynamically set or override your PWA’s basic configuration directly via JavaScript — without needing to create a new app for every variation.
What Is appConfig?
The new appConfig method lets you customize essential app properties like the name, description, start URL, orientation, language, icons, and screenshots on a per-page or per-path basis.
This is perfect for platforms with dynamic content, like HTML5 game portals or product-based websites. For example, if your site hosts 100+ games or products, you no longer need to build a separate Liteit app for each one. Instead, configure a single app and tailor its behavior per game or product using this new method.
Why It Matters
- Efficiency: Avoid managing dozens or hundreds of separate PWAs.
- Flexibility: Change app metadata dynamically based on the page context.
- Simplicity: Integrate directly via JavaScript — no rebuilds or redeployments needed.
Example Usage
window.LIA_API.appConfig = {
// The visible name of your app.
// This will be shown in the install prompt and on the user's device once installed.
app_name: "MyShop Lite",
// A short description of your app's purpose or features.
// May be used in install banners or metadata previews.
app_description: "A fast, modern shopping experience in your browser.",
// The URL that the app should open when launched from the home screen.
// Must be a relative path or query (e.g., "/home", "/start", or "?app=true").
app_start_url: "/?app=true",
// Preferred screen orientation when the app is opened.
// Options: 'portrait', 'landscape', or 'any'.
app_orientation: "portrait",
// The language code for your app, using ISO 639-1 (e.g., 'en' for English, 'fr' for French).
app_language: "en",
// The main app icon (512x512 recommended).
// Used in install prompts and as the app icon on the device.
app_icon: "https://myshop.liteit.app/icon.webp",
// (Optional) Screenshots to display in supported install banners or UI previews.
// Images must be hosted on the same domain as your main app URL.
app_screenshots: [
"https://myshop.liteit.app/screenshot_1.png",
"https://myshop.liteit.app/screenshot_2.png",
"https://myshop.liteit.app/screenshot_3.png",
"https://myshop.liteit.app/screenshot_4.png"
]
};
Each field is optional, but together they allow your app to behave and appear exactly how you want it to — tailored for every product or game page.
Ready to Try It?
Just add your custom appConfig object before your Liteit integration script on any page you want to personalize. Our engine will pick it up and apply the changes instantly.
We’re constantly working to make Liteit.app more flexible and developer-friendly. If you have feedback or use cases you'd like to share, let us know!