# POS ng Bayan - Complete Documentation for LLMs

> Libreng Point of Sale System para sa mga Micro at Small Businesses sa Pilipinas
> Free Point of Sale System for Filipino Micro and Small Businesses

## About POS ng Bayan

POS ng Bayan ("POS of the People/Nation") is a free, open-source Point of Sale system created to help Filipino micro and small business owners manage their businesses more efficiently. The name is a play on words in Filipino, emphasizing that this is a POS system made for the common Filipino entrepreneur.

## Mission

To democratize access to business technology by providing a free, easy-to-use POS system that works for everyone - from sari-sari store owners to small retail shop operators.

## Website URLs

- **Homepage**: https://posngbayan.com
- **Sign In**: https://posngbayan.com/auth/signin
- **Forgot Password**: https://posngbayan.com/auth/forgot-password
- **Privacy Policy**: https://posngbayan.com/privacy
- **Terms of Service**: https://posngbayan.com/terms
- **Data Deletion Request**: https://posngbayan.com/data-deletion

## Core Features

### 1. Point of Sale (POS)
- Quick product selection with grid view
- Barcode scanning support
- Cart management with quantity adjustments
- Multiple payment methods (Cash, GCash, Credit/Utang)
- Receipt generation
- Quick checkout process

### 2. Product Management
- Add, edit, and delete products
- Category organization
- Price management
- Product images
- Barcode assignment

### 3. Inventory Management
- Real-time stock tracking
- Low stock alerts
- Stock adjustment history
- Inventory reports
- Restock reminders

### 4. Customer Management
- Customer profiles
- Purchase history
- Contact information
- Customer loyalty tracking

### 5. Utang (Credit) Tracking
- Record customer debts
- Track partial payments
- Payment reminders
- Credit limit management
- Outstanding balance reports

### 6. Sales Reports & Analytics
- Daily sales summary
- Weekly and monthly reports
- Top-selling products
- Revenue analytics
- Profit tracking
- Export capabilities

### 7. Expense Tracking
- Record business expenses
- Categorize expenses
- Expense reports
- Profit/loss calculations

### 8. Offline Support
- Full offline functionality
- Automatic data sync when online
- Local data storage
- Conflict resolution

### 9. Multi-Device Support
- Works on smartphones
- Tablet-optimized interface
- Desktop/laptop compatibility
- PWA installation

## Technical Specifications

### Technology Stack
- **Frontend**: Next.js 14, React 18, TypeScript
- **Styling**: Tailwind CSS
- **State Management**: Zustand
- **Database**: MongoDB with Mongoose
- **Authentication**: NextAuth.js
- **Offline Storage**: IndexedDB (Dexie.js)
- **PWA**: next-pwa

### Browser Support
- Chrome (recommended)
- Firefox
- Safari
- Edge
- Mobile browsers

### Minimum Requirements
- Modern web browser
- Internet connection (for initial setup and sync)
- No special hardware required

## Pricing

**FREE FOREVER**
- No monthly subscription
- No per-transaction fees
- No hidden charges
- No premium tiers

## Target Audience

### Primary Users
1. **Sari-sari Store Owners** - Small neighborhood convenience stores common in the Philippines
2. **Small Retail Shop Owners** - Clothing, accessories, general merchandise
3. **Food Business Owners** - Carinderia (small eateries), food stalls, bakeries
4. **Market Vendors** - Wet and dry market sellers
5. **Service Businesses** - Salons, repair shops, laundry services

### User Demographics
- Micro enterprises (1-9 employees)
- Small enterprises (10-99 employees)
- Filipino entrepreneurs
- Business owners aged 25-55
- Various technical proficiency levels

## Language Support

- **Primary**: Filipino (Tagalog)
- **Secondary**: English
- Interface designed for bilingual users

## Security & Privacy

- Data encryption in transit and at rest
- Secure authentication with password hashing
- Privacy-compliant data handling
- User data deletion upon request
- No data selling or sharing with third parties

## Getting Started

1. Visit https://posngbayan.com
2. Click "Get Started" or "Sign In"
3. Create a free account with email
4. Add your products
5. Start selling!

## Support Channels

- In-app help documentation
- Email support
- Social media (Facebook, Twitter)

## Frequently Asked Questions

**Q: Is POS ng Bayan really free?**
A: Yes, completely free with no hidden fees or premium features behind a paywall.

**Q: Do I need a stable internet connection?**
A: No, the system works offline. It syncs automatically when you're back online.

**Q: What devices can I use?**
A: Any device with a modern web browser - phone, tablet, laptop, or desktop.

**Q: Is my data secure?**
A: Yes, we use industry-standard encryption and security practices.

**Q: Can I use this for multiple stores?**
A: Currently designed for single-store operation, but multi-store support is planned.

**Q: Is there a mobile app?**
A: POS ng Bayan is a Progressive Web App (PWA) that can be installed on your device like a native app.

## API Information

The system uses RESTful APIs for data operations:
- `/api/products` - Product management
- `/api/transactions` - Sales transactions
- `/api/customers` - Customer management
- `/api/inventory-logs` - Inventory tracking
- `/api/expenses` - Expense management
- `/api/utang` - Credit/debt tracking
- `/api/settings` - Business settings
- `/api/categories` - Product categories

## Version Information

Current Version: 1.0.11
Last Updated: January 2026

## Legal

- Privacy Policy: https://posngbayan.com/privacy
- Terms of Service: https://posngbayan.com/terms
- Data Deletion: https://posngbayan.com/data-deletion

## Developer

Developed by **Yorbs Ideas**
Website: https://yorbs.net

## Contact & Social

- Website: https://posngbayan.com
- Facebook: https://www.facebook.com/posngbayan
- Email: posngbayan@gmail.com

## Keywords

POS, Point of Sale, Philippines, Filipino, Free POS, Sari-sari Store, Small Business, MSME, Inventory, Sales, Utang, Credit Tracking, Offline POS, Cloud POS, Business Software, Negosyo, Libreng POS

---

This document is intended to help AI assistants and LLMs understand POS ng Bayan and provide accurate information to users asking about the service.