# Neptou

> Built and lead the full technical stack for Neptou, a Nepal travel companion app, across a native SwiftUI iOS app, a FastAPI and Postgres backend with Claude-powered planning, and a Next.js website and admin panel.

Apr 2025 - Present · ongoing · Swift, SwiftUI, FastAPI, PostgreSQL, Next.js, Claude API, Kotlin, Xcode Cloud

## Overview

Neptou is a travel companion for Nepal. It brings handpicked places from across the country into one app, from the temples of Kathmandu Valley to Himalayan treks. Travelers can discover destinations, plan multi-stop trips, and explore on a map, even without a connection.

Neptou is an early-stage, pre-revenue startup. The iOS app is live on the App Store, and Neptou was one of four national winners of Code for Impact 2026.

## Role

As Head of Technology, I built and run the technical side of the product across three connected codebases: the iOS app, the backend that powers it, and the website and admin panel.

- **iOS app.** A native SwiftUI app using only Apple frameworks. It works offline first: data is stored on the device and synced from the backend. An on-device trip planner orders districts and stops using nearest-neighbour plus 2-opt optimization. Maps use MapKit clustering and the same geohashing as the server. 40 unit tests cover the optimizer, geohashing, recommendations, and data merging.
- **Backend.** A FastAPI service on Supabase Postgres, deployed on Render with Docker. A versioned API keeps app builds already in users' hands working. Claude-powered endpoints handle chat, recommendations, and itinerary optimization, with rate limiting. An admin API uses JWT auth, role-based permissions, and a verification workflow for content.
- **Website and admin panel.** A Next.js static site on GitHub Pages with SEO and AI-search work (structured data, `llms.txt`, Apple Smart App Banner). It also hosts a role-aware staff dashboard for managing places, foods, festivals, hotels, guides, and emergency contacts.
- **Android.** Porting the app to Kotlin and Jetpack Compose, using AI-assisted development.

## Stack

- iOS: Swift, SwiftUI, SwiftData, MapKit, CoreLocation, XCTest
- Backend: Python, FastAPI, PostgreSQL (Supabase), Pydantic, Anthropic Claude API
- Web: Next.js, React, TypeScript, Tailwind CSS
- Delivery: Xcode Cloud (TestFlight and App Store), GitHub Actions, Render, Docker
- In progress: Kotlin, Jetpack Compose

## Outcomes

- Shipped Neptou to the App Store, followed by regular feature and stability updates, with automated builds through Xcode Cloud.
- Led engineering for one of four national winners of Code for Impact 2026, out of 190 applicant teams from across Nepal.

## Links

- [Download on the App Store](https://apps.apple.com/app/apple-store/id6756244066?pt=128211987&ct=dhirajkc195-portfolio&mt=8)
- [Neptou website](https://neptou.github.io)

## Recognition

- [National Winner, Code for Impact 2026](https://dhirajkc195.com.np/recognition/code-for-impact-2026.md) (Jul 2026, U.S. Embassy Nepal × Aadyanta Advisory)

## Related experience

- Head of Technology, Neptou (Apr 2025 – Present)

---

HTML version: https://dhirajkc195.com.np/projects/neptou/
