NapNav เป็นแอปพลิเคชันบน iOS พัฒนาด้วย SwiftUI และ ActivityKit ออกแบบมาเพื่อแก้ปัญหาของคนเดินทางด้วยระบบขนส่งสาธารณะ (รถไฟฟ้า BTS/MRT, รถไฟชานเมือง, รถเมล์ หรือรถตู้) ที่เหนื่อยล้าจากการทำงานหรือเรียน แล้วต้องการงีบหลับพักสายตาระหว่างทาง โดยไม่ต้องกังวลว่าจะนอนเพลินจนเลยป้ายหรือสถานีปลายทาง
เมื่อเริ่มทริป NapNav จะติดตามตำแหน่งเพื่อคำนวณระยะทางที่เหลือ และส่งสัญญาณเตือนเมื่อเข้าใกล้รัศมีที่กำหนดไว้ พร้อมแสดงผลผ่าน Live Activity บน Lock Screen และ Dynamic Island ช่วยให้เหลือบดูสถานะการเดินทางได้ตลอดเวลาโดยไม่ต้องปลดล็อกเครื่อง
- ระบบเตือนตามพิกัดจริง (Proximity & Location-based Alert)
- เลือกระยะเตือนล่วงหน้าได้ตามต้องการ (500 ม., 1 กม., 2 กม. หรือกำหนดเองตั้งแต่ 100 ม. ถึง 5 กม.)
- วงรัศมีบนแผนที่ปรับขนาดตามระยะที่เลือกแบบเรียลไทม์
- ระบบตรวจสอบความพร้อมของสัญญาณและส่งการเตือนเมื่อเข้าสู่รัศมีที่เลือก
- Live Activities & Dynamic Island
- แสดงสถานะทริป ระยะทางคงเหลือ และชื่อจุดหมายบน Lock Screen และ Dynamic Island ตลอดการเดินทาง
- แตะเพื่อเปิดแอป หรือกดหยุดทริปพร้อมหน้าต่างยืนยันความปลอดภัยเพื่อป้องกันการกดพลาด
- ตั้งค่ารูปแบบการแจ้งเตือน (Customizable Alerts)
- รองรับทั้ง AlarmKit (เสียงเตือนแบบนาฬิกาปลุก) และ UserNotifications ตามการอนุญาตสิทธิ์และความพร้อมของเครื่อง
- ปรับแต่งระดับเสียงและเปิด/ปิดระบบสั่นได้จากหน้าตั้งค่าการเตือน
- ค้นหาสถานที่และรายการโปรด (Search & Favorites)
- ค้นหาสถานีและสถานที่ปลายทางได้อย่างรวดเร็วผ่าน Apple Maps (MapKit)
- บันทึกสถานที่ที่ใช้บ่อย (Favorites) เช่น "บ้าน", "ที่ทำงาน" พร้อมเลือก Custom Emoji ประจำจุดหมาย แตะครั้งเดียวเริ่มเดินทางได้ทันที
- บันทึกประวัติจุดหมายล่าสุด (Recent Destinations) เพื่อความสะดวกรวดเร็ว
- การติดตามตำแหน่งและข้อจำกัดของสัญญาณ (Location & Transit Limitations)
- ติดตามตำแหน่งเฉพาะขณะทริปกำลังทำงาน (Active Trip) เพื่อช่วยประหยัดแบตเตอรี่
- มีคำแนะนำและข้อจำกัดเรื่องสัญญาณ GPS ในกรณีที่เดินทางในอุโมงค์รถไฟฟ้าใต้ดิน (MRT)
- รองรับ 2 ภาษาเต็มรูปแบบ (Bilingual Support)
- รองรับทั้งภาษาไทย (Thai) และภาษาอังกฤษ (English) ปรับเปลี่ยนตามภาษาของระบบหรือเลือกเองในแอป
- การช่วยการเข้าถึง (Accessibility)
- รองรับ Dynamic Type สำหรับขยายขนาดตัวอักษร, Reduce Motion สำหรับลดการเคลื่อนไหวของแอนิเมชัน และระบุ Accessibility Labels/Values สำหรับ VoiceOver
มุ่งให้ ตั้งทริปง่าย พักระหว่างทางได้มั่นใจ และตื่นทันลงรถ โดยมีแนวทางพัฒนาดังนี้:
- ใช้งานประจำวันคล่องขึ้น — แสดง Favorites บนแผนที่ ค้นหาด้วยชื่อที่ตั้งเอง จัดลำดับรายการ ย้อนคืนหลังลบ และจำทริปที่ตั้งค้างไว้
- เริ่มทริปได้เร็วขึ้น — รับจุดหมายที่แชร์จาก Maps บันทึกทริปที่ใช้ซ้ำ และเปิดนำทางใน Apple Maps / Google Maps ควบคู่กับการเตือน
- ปลุกให้เหมาะกับแต่ละคน — เสนอปรับระยะเตือนจาก feedback เตือนสองจังหวะ ตั้งเวลางีบสูงสุด เพิ่มข้อความเตือนส่วนตัว และแสดงความพร้อมของตำแหน่ง/การเตือนให้ชัดขึ้น
- รองรับทริปหลายช่วง — เพิ่มจุดเตือนตามลำดับในทริปเดียว แยกจุดลงรถกับจุดหมายสุดท้าย และแสดงเส้นทางเดินต่อ
งานที่ทำคู่ขนานกันได้คือปรับหน้า App Store และเว็บไซต์ให้ค้นพบง่ายขึ้นผ่านการค้นหาและ AI พร้อมวิธีใช้ FAQ และลิงก์ดาวน์โหลด ส่วนการเตือนซ้ำเพื่อยืนยันว่าตื่น การใช้ Watch/หูฟัง และข้อมูลขนส่งสาธารณะจะเริ่มจากการทดลอง
รายการเหล่านี้เป็นแนวทางที่อยู่ระหว่างพิจารณา ยังไม่ใช่ฟีเจอร์ที่เปิดใช้แล้วหรือกำหนดวันปล่อย ลำดับอาจปรับตาม feedback โดยให้ความน่าเชื่อถือของการเตือนมาก่อน
- ดาวน์โหลดแอป: NapNav บน App Store
- หน้าเว็บไซต์หลัก: telnwza.github.io/NapNav
- นโยบายความเป็นส่วนตัว (Privacy Policy): telnwza.github.io/NapNav/privacy.html
- ศูนย์ช่วยเหลือและคำถามที่พบบ่อย (Support & FAQ): telnwza.github.io/NapNav/support.html
NapNav พัฒนาขึ้นโดยยึดหลัก Clean Architecture และ Modern iOS Concurrency:
- UI Framework: SwiftUI (iOS 18+)
- Concurrency: Swift Concurrency (
async/await,Task,@MainActor) บน Swift 6.0 - Location Services: CoreLocation, MapKit (
PlaceSearchService) - Live Activities & Widgets: ActivityKit, WidgetKit
- Alerts & Audio: AlarmKit, UserNotifications, AVFoundation
- State Management: MV Pattern ร่วมกับ Observation (
TripStore) แยก Business Logic ออกจาก View ชัดเจน - Persistence: Local Storage Protocol-oriented (
UserDefaultsTripPersistence) - Automated Testing: ชุดการทดสอบ Swift Testing ครอบคลุม Proximity logic, Trip recovery, Alert delivery และ Localization
NapNav/
├── NapNav/ # ซอร์สโค้ดหลักของแอป
│ ├── DestinationSelection.swift # UI แผนที่หลัก, เลือกจุดหมาย, และแถบควบคุม
│ ├── AlertSettingsView.swift # หน้าตั้งค่าเสียงและรูปแบบการปลุก
│ ├── OnboardingView.swift # หน้าแนะนำการใช้งานและขอสิทธิ์
│ ├── DomainModels.swift # Model ข้อมูลหลัก (Trip, Destination, Location)
│ ├── TripStore.swift # State Machine จัดการสถานะและวงจรชีวิตของทริป
│ ├── TriggerPolicy.swift # ตรรกะการคำนวณระยะทางและการตัดสินใจสั่งเตือน
│ ├── LiveActivityManager.swift # ตัวจัดการ Dynamic Island & Live Activity
│ ├── SystemClients.swift # ตัวประสานงาน CoreLocation, Audio, Notifications
│ └── RootView.swift # หน้าจอ Root และการเปลี่ยนผ่านสถานะ
├── NapNavWidget/ # Widget Extension สำหรับ Dynamic Island & Live Activity
│ └── TripLiveActivityWidget.swift
├── NapNavTests/ # ชุดแบบทดสอบ Swift Testing และ Mock Objects
├── TestRoutes/ # ไฟล์ GPX จำลองพิกัดการเดินทางสำหรับทดสอบ
└── docs/ # หน้าเว็บ GitHub Pages (Landing, Privacy, Support)
- Mac ที่ใช้ macOS ซึ่งรองรับ Xcode 16 หรือใหม่กว่า
- Xcode 16.0 หรือใหม่กว่า (โปรเจกต์ใช้ Swift 6.0)
- อุปกรณ์ iPhone ที่ใช้ iOS 18.0+ หรือ iPhone Simulator ใน Xcode
-
Clone คลังโค้ดนี้:
git clone https://github.com/Telnwza/NapNav.git cd NapNav -
เปิดโปรเจกต์ใน Xcode:
open NapNav.xcodeproj
-
ตั้งค่า Signing & Capabilities:
- เลือก Root Project
NapNavในแถบ Project Navigator - ไปที่แท็บ Signing & Capabilities
- เปลี่ยน Team เป็น Apple Developer Account ของคุณ (หรือ Personal Team)
- ปรับแก้ Bundle Identifier ทั้งใน Target
NapNavและNapNavWidgetให้ตรงกับ Team ของคุณ
- เลือก Root Project
-
เลือก Device หรือ Simulator แล้วกด Run (
Cmd + R)
โปรเจกต์มาพร้อมชุด Unit Tests ครอบคลุมฟังก์ชันสำคัญ:
- รันแบบทดสอบทั้งหมดได้ง่ายๆ ด้วยคีย์ลัด
Cmd + Uใน Xcode
ในโฟลเดอร์ TestRoutes/ มีไฟล์เส้นทาง GPX เตรียมไว้สำหรับทดสอบบน Xcode Simulator:
- สั่งรันแอปบน iPhone Simulator
- ไปที่เมนูของ Simulator: Features > Location > Custom Location... หรือเลือกโหลด GPX จาก:
approach-destination.gpx(จำลองการเดินทางเข้าใกล้จุดหมายเพื่อทดสอบเสียงเตือน)pass-outside.gpx(จำลองการเดินทางผ่านนอกเขต)gps-jump.gpx(จำลองกรณีสัญญาณ GPS กระโดด)
ยินดีต้อนรับผู้พัฒนาทุกท่านที่มีความสนใจจะร่วมปรับปรุง NapNav:
- Fork โปรเจกต์นี้
- สร้าง Feature Branch ของคุณ (
git checkout -b feature/AmazingFeature) - Commit การเปลี่ยนแปลง (
git commit -m 'Add some AmazingFeature') - Push ไปยัง Branch ของคุณ (
git push origin feature/AmazingFeature) - เปิด Pull Request ได้เลย
หาก NapNav ช่วยให้คุณเดินทางและงีบหลับได้อย่างสบายใจ ไม่ต้องพะวงเรื่องเลยป้าย และอยากร่วมเป็นส่วนหนึ่งในการสนับสนุนโปรเจกต์โอเพนซอร์สนี้ คุณสามารถร่วมสนับสนุนค่าน้ำชา/กาแฟให้กับผู้พัฒนาได้ที่:
โปรเจกต์นี้เผยแพร่ภายใต้ใบอนุญาต GNU General Public License v3.0 (GPL-3.0) ดูรายละเอียดเพิ่มเติมได้ที่ไฟล์ LICENSE
NapNav
Copyright (C) 2026 Telnwza / NapNav Contributors
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.