← Developer home

Starter Kits

ကိုယ်ပိုင် clone ကူး၍ ပိုင်ဆိုင်နိုင်သော mobile app template များ

Open-source mobile app templates you clone and own. Fork one, drop in your brand and a sandbox key, and publish under your own Apple / Google accounts. DOEH provides the SDK, APIs, sandbox, and the template — you own the app.

သင် clone ကူး၍ ပိုင်ဆိုင် နိုင်သော open-source mobile app template များ။ တစ်ခုကို fork လုပ်၊ သင့်အမှတ်တံဆိပ်နှင့် sandbox key ထည့်ကာ သင့်ကိုယ်ပိုင် Apple / Google account များဖြင့် ထုတ်ဝေပါ။ DOEH က SDK၊ API၊ sandbox နှင့် template ကို ပေးသည် — app ကို သင် ပိုင်ဆိုင်သည်။

DOEH Loyalty Starter v1.2.1 · Frozen

Clone → Brand → Deploy Broker → Submit Stores

A complete, store-publishable loyalty app built on the stable Loyalty module: look up a member, earn points by purchase amount, redeem, and read the ledger — every call through the published TypeScript SDK, never raw HTTP.

တည်ငြိမ်သော Loyalty module ပေါ်တွင် တည်ဆောက်ထားသော store တွင် ထုတ်ဝေနိုင်သည့် loyalty app အပြည့်အစုံ — member ရှာ၊ ဝယ်ယူပမာဏအလိုက် point ရ၊ redeem လုပ်၊ ledger ဖတ် — ခေါ်ဆိုမှုတိုင်းကို ထုတ်ဝေပြီး TypeScript SDK မှတစ်ဆင့်၊ raw HTTP ဖြင့် ဘယ်တော့မှ မဟုတ်။

View the template repository →

template repository ကို ကြည့်ပါ →

Included

ပါဝင်သည်

  • Loyalty (earn / redeem / ledger)
  • Sandbox-first, safe by default
  • Mock mode (build with no key)
  • Sandbox Inspector (dev-only)
  • Five example brand packs
  • Reference token broker
  • EAS build & submit docs
  • Loyalty (earn / redeem / ledger)
  • Sandbox ဦးစားပေး၊ default အားဖြင့် ဘေးကင်း
  • Mock mode (key မပါဘဲ build)
  • Sandbox Inspector (dev-only)
  • နမူနာ brand pack ၅ ခု
  • Reference token broker
  • EAS build နှင့် submit docs

Not included

မပါဝင်ပါ

  • Merchant admin panel
  • Coupon CMS
  • Analytics dashboards
  • Tier management / CRUD
  • Merchant admin panel
  • Coupon CMS
  • Analytics dashboard များ
  • Tier management / CRUD

These are first-party / platform concerns — the template is for building your app, not replacing the merchant back-office.

ဤအရာများသည် first-party / platform ကိစ္စများ ဖြစ်သည် — template သည် သင့် app တည်ဆောက်ရန်အတွက်ဖြစ်ပြီး merchant back-office ကို အစားထိုးရန် မဟုတ်ပါ။

Quick start

အမြန်စတင်ခြင်း

git clone https://github.com/beyondplusmyanmar-lab/doeh-loyalty-template
cd doeh-loyalty-template
pnpm bootstrap        # one-command setup
pnpm doctor           # verify brand, ids, assets, env
pnpm start            # run in Expo (mock mode needs no key)

Add a sandbox key to exercise the real API end-to-end:

အစစ်အမှန် API ကို အစအဆုံး စမ်းသပ်ရန် sandbox key တစ်ခု ထည့်ပါ —

export DOEH_API_KEY=sk_test_<keyid>_<secret>
pnpm smoke:sandbox    # earn → balance → redeem → 409 → idempotent replay

Example brands

နမူနာ brand များ

Five branding-only packs in examples/ — copy one over brand.json, run pnpm doctor, and you have a re-skinned app. No business logic, just identity.

examples/ ထဲတွင် branding သက်သက် pack ၅ ခု — တစ်ခုကို brand.json ပေါ် ကူးချ၊ pnpm doctor ကို run လျှင် အသွင်ပြောင်းပြီးသား app ရသည်။ business logic မပါ၊ identity သက်သက်သာ။

☕
Coffee Shopကော်ဖီဆိုင်
branding onlybranding သက်သက်
💄
Beauty Salonအလှပြင်ဆိုင်
branding onlybranding သက်သက်
🥩
Bakeryမုန့်ဆိုင်
branding onlybranding သက်သက်
🍽
Restaurantစားသောက်ဆိုင်
branding onlybranding သက်သက်
📚
Bookstoreစာအုပ်ဆိုင်
branding onlybranding သက်သက်

Developer journey

Developer ၏ ခရီးစဉ်

  1. Get a sandbox sk_test_… key from the portal.
  2. Clone the Loyalty Starter.
  3. Run pnpm bootstrap.
  4. Edit brand.json — name, colors, icon, bundle ids.
  5. Run pnpm doctor to verify the brand and config.
  6. Deploy the reference token broker (holds sk_live_ server-side).
  7. Test: pnpm smoke:sandbox and a device preview build.
  8. Submit to TestFlight / Play Internal under your own accounts.
  1. portal မှ sandbox sk_test_… key တစ်ခု ရယူပါ။
  2. Loyalty Starter ကို clone ကူးပါ။
  3. pnpm bootstrap ကို run ပါ။
  4. brand.json ကို တည်းဖြတ်ပါ — အမည်၊ အရောင်၊ icon၊ bundle id များ။
  5. brand နှင့် config ကို စစ်ဆေးရန် pnpm doctor ကို run ပါ။
  6. reference token broker ကို deploy လုပ်ပါ (sk_live_ ကို server ဘက်တွင် ထိန်းသိမ်းသည်)။
  7. စမ်းသပ် — pnpm smoke:sandbox နှင့် device preview build တစ်ခု။
  8. ကိုယ်ပိုင် account များဖြင့် TestFlight / Play Internal သို့ တင်ပါ။

Production deployment & broker ownership

Production deploy နှင့် broker ပိုင်ဆိုင်မှု

Sandbox apps talk to DOEH directly with a sk_test_… key. A production app must never embed a live key — it calls a broker you deploy and own, which holds the sk_live_… secret server-side and swaps it in. The Starter Kit ships the broker as reference code you run yourself.

Sandbox app များသည် sk_test_… key ဖြင့် DOEH နှင့် တိုက်ရိုက် ဆက်သွယ်သည်။ production app သည် live key ကို ဘယ်တော့မှ အတွင်းမှာ မထည့်ရ — ၎င်းသည် သင် deploy လုပ်၍ ပိုင်ဆိုင်သော broker ကို ခေါ်သည်။ ထို broker က sk_live_… secret ကို server ဘက်တွင် ထိန်းသိမ်းပြီး အစားထိုးပေးသည်။ Starter Kit သည် broker ကို သင်ကိုယ်တိုင် run သော reference code အဖြစ် ပေးသည်။

Sandbox

App
 └─ sk_test_…
     ↓
DOEH Sandbox API

No broker required.

broker မလိုအပ်ပါ။

Production

App
 └─ short-lived token
     ↓
Merchant Broker  (you deploy)
 └─ sk_live_…
     ↓
DOEH API

Broker holds the secret; the app never sees it.

broker က secret ကို ထိန်းသိမ်းသည်။ app က ၎င်းကို ဘယ်တော့မှ မမြင်ရ။

DOEH provides

DOEH က ပေးသည်

You provide

သင် ပေးရသည်

Broker ownership. DOEH hosts no customer brokers. The reference broker is sample infrastructure for merchants who publish production mobile apps — you deploy and operate it. Sandbox apps run without a broker using sk_test_… keys. A planned publishable-key capability would later make the broker optional.

Broker ပိုင်ဆိုင်မှု။ DOEH သည် customer broker မည်သည့်ခုမျှ host မလုပ်ပါ။ reference broker သည် production mobile app များ ထုတ်ဝေသော merchant များအတွက် နမူနာ infrastructure ဖြစ်ပြီး — သင်ကိုယ်တိုင် deploy လုပ်၍ လည်ပတ်စေသည်။ Sandbox app များသည် sk_test_… key ဖြင့် broker မပါဘဲ အလုပ်လုပ်သည်။ စီစဉ်ထားသော publishable-key စွမ်းဆောင်ရည်က နောင်တွင် broker ကို မဖြစ်မနေ မလိုအောင် လုပ်ပေးမည်။

Full walkthrough and checklists live in the template's docs/ (ONBOARDING, EAS, PRODUCTION, SUBMISSION). The starter is frozen at v1.2.1: it gains bug fixes, SDK parity, and Expo upgrades, but no new merchant-admin surface.

အပြည့်အစုံ လမ်းညွှန်နှင့် checklist များကို template ၏ docs/ (ONBOARDING, EAS, PRODUCTION, SUBMISSION) တွင် တွေ့နိုင်သည်။ starter ကို v1.2.1 တွင် frozen လုပ်ထားသည် — bug fix များ၊ SDK parity နှင့် Expo upgrade များ ရသော်လည်း merchant-admin မျက်နှာစာ အသစ် မပါပါ။