08Case study · Family heritage app

Pustau: A Nepali Family Tree, Tithi & Patro App

Pustau is a digital vamshavali: a private family tree for Nepali families, with tithi and patro in Bikram Sambat and shraddha dates worked out the way a priest would. I designed and built it with Next.js and PostgreSQL, Nepali first with English one tap away, and it is live at pustau.com.

  • BS to AD conversion verified for every day from 1970 to 2100
  • Shraddha dates for the coming year, without guessing
  • Names written in Nepali or English script
Pustau Nepali family tree app shown on desktop and mobile
  • RoleProduct & full-stack engineering
  • TypeConsumer web app
  • LanguagesNepali first, English available
  • StatusLive at pustau.com

01The problem

The Problem: A Family History That Lives in One Memory

A family’s vamshavali often lives in one elder’s memory or a notebook. When that person is gone, names, relationships and villages go with them.

Ritual dates make it harder. A shraddha is set by the tithi of a death in the lunar calendar, which moves against both the Bikram Sambat and the Gregorian calendars every year. Families rely on a priest to work it out.

हाम्रा कथा। हाम्रा मान्छे। हाम्रा जरा।Our stories. Our people. Our roots. Pustau’s promise, on its home page.

02The solution

What I Built: A Private Vamshavali with a Calendar Engine

Pustau is a private family record. Members add people and relationships to a shared family tree, and record the places and stories behind them. The app shows tithi and patro in Bikram Sambat and works out shraddha dates the way a priest would.

Nepali is the default language, English is one tap away, and names can be written in either script. I build websites and web apps in Nepali Unicode the same way, and Nimtto shows Bikram Sambat dates beside AD for every ceremony.

A diagram of three generations in a family tree, the core of every Pustau record.

03Features

What Pustau Does for a Nepali Family

A small feature list on purpose: the family record, the calendar that depends on it, and access that stays simple for elders.

Family Record

  • A shared family tree
  • Names in Nepali or English
  • Places and stories for each person

Calendar

  • Tithi and patro in Bikram Sambat
  • BS to AD conversion verified from 1970 to 2100
  • Shraddha dates calculated the way a priest would

Access

  • Sign-up with only a name, an email and a password
  • Passwords of at least 10 characters
  • Installs as an app on the phone

04Architecture

Pustau Architecture and Tech Stack

Pustau is a Next.js 16 application in TypeScript with PostgreSQL, packaged with Docker. The whole app sits behind sign-in, because a family record is private by nature.

  1. Family memberSigned-in appNepali first; installs on the phone
  2. EdgeCloudflareHSTS with includeSubDomains
  3. AppNext.js 16 + TypeScriptPackaged with Docker
  4. DataPostgreSQLPrivate family records

The Pustau Tech Stack

A nonce-based Content-Security-Policy runs in report-only mode with a reporting endpoint, so violations are collected before the policy is enforced and nothing breaks for a family mid-entry.

Framework
Next.js 16TypeScript
Data
PostgreSQL
Hosting
DockerCloudflare
Security
HSTS with includeSubDomainsNonce-based CSP with strict-dynamic, in report-only mode

05Engineering

Engineering Decisions Behind Pustau

Pustau is a small product with a hard core: a calendar engine that has to be exactly right, in two languages and two scripts.

01

A Calendar Engine That Families Can Trust

The Bikram Sambat calendar has no fixed formula; month lengths are published year by year. Pustau’s BS to AD conversion is verified against published data for every day from 1970 to 2100, which covers everyone living today and the next generation. Checking output against published data is what logic verification means in practice.

02

Shraddha Dates, Worked Out Properly

A shraddha follows the lunar tithi of the day a person died, so its date changes every year. Pustau calculates it the way a priest would, so families can see the coming year’s dates without guessing. Getting data like this exactly right is the heart of good database design.

06Status

Where Pustau Stands Today

Pustau is live at pustau.com. Families sign up with a name, an email and a password and start building their record.

Live

It is a small product with a hard core: a calendar engine that has to be exactly right, in two languages and two scripts, behind sign-in because a family’s record belongs to the family.

What I’d Do Next

  1. Enforce the Content-Security-Policy once the report-only data is clean.
  2. Email reminders before each shraddha date, for everyone in the family who wants them.
  3. A printable vamshavali, so the family tree can go on paper for the elders who prefer it.

Related services

Need an App Like Pustau?

These are the services behind this case study. Each page lists prices, timelines and how I work, and every starting price is on my services page.

Every project, with its stack and status side by side, are in my web development portfolio, and the person behind them is on my about page.

FAQ: Pustau Family Tree App

What Pustau does, how accurate its dates are and how it keeps a family’s record private.

Ask me on WhatsApp

What is Pustau?

Pustau is a private family record for Nepali families, a digital vamshavali. Members build a shared family tree with names, places and stories, and the app shows tithi and patro in Bikram Sambat and works out shraddha dates. Nepali is the default language, with English one tap away.

How Accurate Is Pustau’s Bikram Sambat to AD Conversion?

Pustau’s BS to AD conversion is verified against published data for every day from 1970 to 2100. The Bikram Sambat calendar has no fixed formula, because month lengths are published year by year, so the app checks against that data rather than trusting a calculation.

How Does Pustau Work Out Shraddha Dates?

A shraddha follows the lunar tithi of the day a person died, so its date moves against both the Bikram Sambat and Gregorian calendars every year. Pustau calculates it the way a priest would, so a family can see the coming year’s dates without guessing.

Is My Family’s Data Private on Pustau?

Yes. The whole app sits behind sign-in, because a family record is private by nature. Sign-up needs only a name, an email and a password of at least 10 characters, the site uses HSTS, and a nonce-based Content-Security-Policy runs in report-only mode before it is enforced.

Which Technologies is Pustau Built With?

Pustau is a Next.js 16 application written in TypeScript, with PostgreSQL for data. It is packaged with Docker and served behind Cloudflare with HSTS, and it installs as an app on the phone, so elders can open it like any other app.

Can You Build an App with Nepali Dates and Language?

Yes. I build web apps in Nepali Unicode, English or both, with Bikram Sambat dates where they matter, as in Pustau and Nimtto. I’ll send a fixed quote after a short call about features, languages and data. See web development in Nepal for prices.

Planning an App Like Pustau?
I’ll Send a Fixed Quote.

Send a short note about your project and budget. I reply within one working day with questions or a first estimate.

Ujjwal RupakhetiReplies within one working day

What are you planning?

Opens WhatsApp with your message started.