Mobile-first, offline-first sari-sari store POS built with Next.js, TypeScript, Dexie, NestJS, Express, PostgreSQL, and MinIO.
Course project: CCE106L Applications Development and Emerging Technologies.
Recorded interface screenshot from the October 2026 UI audit.
- Checkout and sale records that operate from the local browser database.
- Inventory tracking, including the smallest sellable unit.
- Customer credit (utang), payment records, expenses, and reports.
- Owner, admin, superadmin, and cashier workflows.
- Encrypted browser-generated cloud backups when connectivity is available.
This repository demonstrates an application prototype; it does not establish a commercial production deployment.
Next.js PWA → Dexie / IndexedDB (working data)
→ NestJS / Express API → PostgreSQL
→ encrypted backup upload → MinIO object storage
- Create a store and add products through the owner/admin workflow.
- Sign in as a cashier and record a cash sale.
- Disconnect networking in the browser and record another sale.
- Confirm local stock and sale records update while offline.
- Reconnect and inspect the backup workflow.
Recorded views: completed sale, offline cashier, and queued offline sale. These screenshots show the recorded UI, not a new acceptance-test run.
npm test
npm run typecheck
npm run buildThe repository also includes real-stack and final-QA scripts. Inspect their environment requirements before running them.
- Install and select the Node.js version in
.nvmrcwithnvm install && nvm use. - Copy
.env.exampleto.envand change the JWT secret and superadmin credentials. - Start PostgreSQL and MinIO with
docker compose up -d --build. - Install dependencies with
npm install. - Apply the database migration with
npm run db:migrate. - Start the PWA and API with
npm run dev.
The PWA opens at http://localhost:3000 and the API at http://localhost:4000.
The API creates or updates the configured superadmin account on startup when SUPERADMIN_EMAIL and SUPERADMIN_PASSWORD are set. Sign in through the Owner / Admin / Superadmin tab to create stores and assign owner/admin access.
The browser database is the working source of truth. Checkout, inventory, utang, expenses, and reports never wait for the API. Cloud backups are encrypted in the browser and uploaded only when connectivity is available.
Amounts are stored as integer centavos. Inventory is stored in the product's smallest sellable unit.
