platform-specialist
Doc-driven platform integration expert. Converts a web app to LINE MINI App (LIFF SDK), PWA (Next.js 16), and Capacitor (iOS/Android). Expo & Tauri are secondary/legacy. ปรัชญาหลัก: ดึง docs จริงล่าสุดก่อนเขียนโค้ดเสมอ — ไม่ freeze snippet ที่จะ rot. Triggers: "LINE MINI App", "LIFF", "LINE OA", "convert to app", "PWA", "add to home screen", "install to phone", "mobile app", "app store", "Capacitor", "iOS", "Android", "native features", "camera", "push notification", "desktop app", "Expo", "Tauri", platform integration.
wasintoh · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add wasintoh/toh-framework --skill platform-specialist技能说明
name: platform-specialist description: > Doc-driven platform integration expert. Converts a web app to LINE MINI App (LIFF SDK), PWA (Next.js 16), and Capacitor (iOS/Android). Expo & Tauri are secondary/legacy. ปรัชญาหลัก: ดึง docs จริงล่าสุดก่อนเขียนโค้ดเสมอ — ไม่ freeze snippet ที่จะ rot. Triggers: "LINE MINI App", "LIFF", "LINE OA", "convert to app", "PWA", "add to home screen", "install to phone", "mobile app", "app store", "Capacitor", "iOS", "Android", "native features", "camera", "push notification", "desktop app", "Expo", "Tauri", platform integration.
Platform Specialist
Make one web app run everywhere — LINE, phone home screen, App Store, desktop — โดย adapt ไม่ rewrite. Core logic เดิมอยู่ครบ, เพิ่มแค่ชั้น platform.
<core_principle>
🥇 Golden Rule: Docs First, Code Second
SDK เหล่านี้ (LIFF, Capacitor, Serwist, Tauri) ออกเวอร์ชันใหม่บ่อยมาก — snippet ที่ hardcode ไว้จะเน่า (rot) ภายในไม่กี่เดือน. ก่อนเขียนโค้ด platform ทุกครั้ง:
- ดึง docs ปัจจุบันก่อน — ผ่าน Context7 (
resolve-library-id→query-docs) หรือ WebFetch หน้า official - เช็ค version ล่าสุดจริง —
npm view @line/liff version,npm view @capacitor/core versionฯลฯ — อย่าจำเลข - แล้วค่อย implement ตาม API ที่ docs ปัจจุบันบอก
หลักการนี้สำคัญกว่าโค้ดตัวอย่างใดๆ ในไฟล์นี้. ตัวอย่างด้านล่างคือ โครง + จุดพลาด ไม่ใช่โค้ดที่ copy ได้เลย. </core_principle>
<line_mini_app>
📱 LINE MINI App (LIFF SDK)
สองคำที่ต้องแยกให้ออก
- LINE MINI App channel = channel ชนิดใหม่ (แนะนำให้สร้างแอปใหม่เป็นชนิดนี้) มาแทนวิธีเดิม (LINE Login channel + ผูก LIFF app เอง). 🇹🇭 ไทยสร้างได้แล้วตั้งแต่ มี.ค. 2026
- LIFF SDK (
@line/liff) = ตัว SDK ที่ยังใช้เหมือนเดิม รันแอป web ข้างใน LINE + เรียก LINE APIs. LINE MINI App ก็ยังใช้ LIFF SDK นี้
📚 Pull docs first
- LINE MINI App overview:
developers.line.biz/en/docs/line-mini-app/ - LIFF API reference:
developers.line.biz/en/reference/liff/ - Release notes (เช็ค version ล่าสุด):
developers.line.biz/en/docs/liff/release-notes/ - Context7:
/line/line-developers-docs-sourceหรือ/websites/developers_line_biz_en_reference_liff
Convert checklist
- สร้าง LINE MINI App channel ใน LINE Developers Console (region = Thailand)
- คัดลอก LIFF ID จาก channel → ใส่เป็น env
NEXT_PUBLIC_LIFF_ID - ติดตั้ง SDK เวอร์ชันล่าสุด:
npm install @line/liff(เช็ค version จาก release notes ก่อน) - Wrap แอปด้วย provider ที่เรียก
liff.init()แล้ว gate การ render จนกว่าจะ resolve - Set endpoint URL ใน channel = URL ที่ deploy จริง (ต้อง HTTPS)
- Adapt UX: safe-area, ปุ่ม action เต็มความกว้าง, ไม่ต้องมีหน้า login แยก (ใช้ LINE profile)
- Test ใน LINE app จริง + ทดสอบ fallback ตอนเปิดนอก LINE
- (ถ้าจะ publish เป็น verified) request review — ไทยต้องผ่าน certified provider
Init outline (โครง ไม่ใช่ไฟล์แช่แข็ง)
// lib/liff.ts — ยืนยัน signature ปัจจุบันกับ LIFF API reference ก่อน
import liff from '@line/liff'
export const initLiff = () => liff.init({ liffId: process.env.NEXT_PUBLIC_LIFF_ID! })
// liff.isInClient() / liff.isLoggedIn() / liff.getProfile() / liff.getAccessToken()
// liff.login() / liff.shareTargetPicker() / liff.sendMessages() / liff.closeWindow()
Provider pattern (providers/liff-provider.tsx): useEffect → await initLiff() → set ready=true → เก็บ isInClient, profile ใน context. สำคัญ: อย่า render feature ที่เรียก LIFF API ก่อน ready. รองรับกรณี init fail (เปิดนอก LINE / SDK error) ด้วย UI fallback ไม่ใช่หน้าขาว.
🩹 Common mistakes (เจอบ่อยจริง)
- เรียก LIFF API ก่อน
liff.init()resolve → error"liff.xxx() was not called". ทุกอย่างต้องรอ init เสร็จก่อน (await/gate render) - ไม่ handle
isInClient()→ แอปพังตอนเปิดใน browser ธรรมดา. เช็คก่อนเรียก in-client-only API (sendMessages,closeWindow,scanCodeV2) และมี fallback. ถ้าต้องรองรับ login นอก LINE ใช้withLoginOnExternalBrowser - Endpoint URL / HTTPS — LIFF บังคับ HTTPS; endpoint ใน console ไม่ตรง URL จริง = init fail. localhost ต้อง tunnel (เช่น ngrok) หรือใช้ LIFF Inspector
liff.getProfile()โดยยังไม่ login / ไม่มี scopeprofile→ เช็คisLoggedIn()+ scope ใน channel ก่อน </line_mini_app>
เป้าหมาย: ผู้ใช้ Add to Home Screen ได้ใน ~1 นาที ไม่ต้องลงอะไรจาก store.
📚 Pull docs first
- Next.js PWA guide:
nextjs.org/docs/app/guides/progressive-web-apps - Serwist (next-pwa successor):
serwist.pages.dev/docs/next/getting-started— เช็ค setup ปัจจุบัน เพราะ config เปลี่ยนบ่อย
Checklist
- Web app manifest →
app/manifest.ts(Next.js Metadata API):name,short_name,start_url,display: "standalone",theme_color,background_color,icons - Icons — อย่างน้อย 192×192 + 512×512 (มี maskable ด้วยยิ่งดี). generate จาก source เดียว
- Service worker — เลือกทางใดทางหนึ่ง:
- Serwist (
@serwist/next) — จัดการ precache manifest + genpublic/sw.jsให้ (configswSrc: 'app/sw.ts',swDest: 'public/sw.js'ผ่านwithSerwistใน next config) — เช็ค getting-started ปัจจุบันก่อน - Native — เขียน
sw.jsเอง (fetch handler + cache) ถ้าอยากคุม 100% ไม่พึ่ง lib
- Serwist (
- Offline พื้นฐาน — cache app shell + offline fallback page; runtime cache สำหรับ API/รูป
- Install prompt — ดัก
beforeinstallprompt(Android/desktop) เก็บ event ไว้ trigger ปุ่ม "ติดตั้ง"; iOS Safari ไม่มี event นี้ → ต้องสอนผู้ใช้ manual (Share → Add to Home Screen) - A2HS UX — บอกวิธีเพิ่มลงหน้าจอแบบภาษาคน แยกคำแนะนำ iOS vs Android
🩹 Common mistakes
- Service worker ต้อง served จาก origin + HTTPS (localhost ยกเว้นได้). path/scope ผิด = ไม่ลง
- Manifest ขาด icon 512 หรือ
display:standalone→ เบราว์เซอร์ไม่เสนอ install - คาดหวัง iOS มี auto install prompt — ไม่มี ต้อง manual เสมอ
- SW cache เก่าค้าง → วาง strategy update (skipWaiting/clientsClaim) + แจ้งผู้ใช้ reload
阅读完整来源 ↗