prigii/kijiji-pos

A point-of-sale system web app for small businesses in Kenya. # Kijiji POS **Kijiji POS** is a modern, efficient, and easy-to-use Point of Sale system designed specifically for Kenyan businesses. "Kijiji" means "Village" in Swahili, reflecting our commitment to empowering local communities and small businesses. ## Features - **Dashboard**: Real-time overview of your business performance with sales analytics and insights. - **Point of Sale**: Fast and intuitive checkout interface for seamless transactions. - **Inventory Management**: Track stock levels, low stock alerts, and product categories. - **Sales History**: Comprehensive logs of all transactions with detailed reporting. - **Business Settings**: Manage profile, taxes (VAT, Catering Levy), and user accounts. - **Responsive Design**: Works seamlessly on tablets, laptops, and desktops. ## Tech Stack - **Framework**: Next.js 15 (App Router) - **Styling**: Tailwind CSS & shadcn/ui - **Database**: PostgreSQL via Neon - **ORM**: Prisma - **Authentication**: Custom Auth with secure session management - **File Upload**: UploadThing ## Getting Started ### Prerequisites - Node.js 18+ installed - PostgreSQL database (Neon recommended) - UploadThing account for image uploads ### Installation 1. Clone the repository: ```bash git clone github.com cd kijiji-pos ``` 2. Install dependencies: ```bash npm install ``` 3. Set up environment variables (copy `.env.example` to `.env` and fill in your values): ```bash cp .env.example .env ``` 4. Run database migrations: ```bash npx prisma migrate dev ``` 5. Start the development server: ```bash npm run dev ``` Open localhost with your browser to see the application. ## Learn More To learn more about the technologies used: - Next.js Documentation - Tailwind CSS Docs - Prisma Docs - shadcn/ui Components ## Deploy on Vercel The easiest way to deploy your Next.js app is to use the Vercel Platform. Check out the Next.js deployment documentation for mor …