📘 App Config Guide

This guide will help you understand how to edit your App Config JSON. By changing these settings, you can control how your webapp works, looks, and behaves.

---

🔗 Main Settings

Home URL (homeUrl)

Your app’s main webapp link.

"homeUrl": "https://yourwebapp.com"

Allowed Origins (allowedOrigins)

A list of webapps that will open inside your webapp. If a webapp is not listed here, it will open in the phone’s browser.
👉 Always add your homeUrl here too.

"allowedOrigins": [
  "https://yourwebapp.com",
  "https://support.yourwebapp.com"
]

---

⚙️ Features

Control basic app behaviors:

• pullToRefresh → Pull down to refresh (true/false)
• downloads → Allow file downloads (true/false)
• push → Enable push notifications (true/false)
• iap → In-app purchases (⚠️ under construction — Do not edit this part until the update nokib03 app builder is released)
• location → Location handling (“prompt”, “always”, “never”)
• incognito → Private browsing mode (true/false)
• externalAppsPreferNative → Open apps like WhatsApp, Maps, etc. in native app (true/false)
• confirmExitOnHome → Ask before exiting (true/false)
• bottomBarEnabled → Show bottom navigation bar (true/false)
• analytics → Enable analytics tracking (true/false)

---

📱 Bottom Navigation Links

BottomNav (bottomNav)

Links for bottom bar buttons:

• shopUrl → Shop page link
• aboutUrl → About page link
• contactUrl → Contact page link
• privacyUrl → Privacy Policy link

"bottomNav": {
  "shopUrl": "https://yourwebapp.com/shop",
  "aboutUrl": "https://yourwebapp.com/about",
  "contactUrl": "https://yourwebapp.com/contact",
  "privacyUrl": "https://yourwebapp.com/privacy"
}

---

🎨 UI & Home Screen

⚠️ Do not edit this part until the update nokib03 app builder is released

UI Theme (ui)

themeMode: “system”, “light”, or “dark”

Home Screen (home)

Controls the intro/home page before your webapp opens:

• showOnLaunch: true/false (show or skip)
• template: layout style (“style1”, “style2”, “style3”)
• title: Heading text
• subtitle: Small description
• primaryColor: Main color (HEX code)
• backgroundColor: Background color (HEX code)
• ctaLabel: Button text
• ctaUrl: Button link
• image: Background image URL (optional)

---

🛒 Store & Sharing

⚠️ Do not edit this part until the update nokib03 app builder is released

• androidPackage: Your Android app package name
• iosAppId: Your iOS App Store ID
• shareText: Default share message when users share your app

---

🔑 Authentication

⚠️ Do not edit this part until the update nokib03 app builder is released

Login options for your webapp:

• google.enabled: true/false + clientId
• apple.enabled: true/false + appId
• facebook.enabled: true/false + appId

---

💰 In-App Purchases (IAP)

⚠️ Do not edit this part until the update nokib03 app builder is released

Currently contains placeholders for:

• RevenueCat (subscription manager)
• Native (Google Play / App Store products)

---

📢 Ads

⚠️ Do not edit this part until the update nokib03 app builder is released

Currently:

• adTriggers = Empty = No ads.

Later: You can add rules here for showing ads on certain pages.

---

✅ That’s it! You can now safely update your App Config JSON and control your app without touching the code.

webapp