https://github.com/zidanhafiz/zenpos
Point of Sales Web Application
https://github.com/zidanhafiz/zenpos
cashier-app cloudinary nextjs possystem postgres prisma shadcn-ui typescript vercel
Last synced: 19 days ago
JSON representation
Point of Sales Web Application
- Host: GitHub
- URL: https://github.com/zidanhafiz/zenpos
- Owner: zidanhafiz
- Created: 2025-01-23T13:23:46.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-17T18:32:57.000Z (over 1 year ago)
- Last Synced: 2025-02-17T19:36:40.754Z (over 1 year ago)
- Language: TypeScript
- Size: 536 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ZenPOS - Modern Point of Sale System
[](https://opensource.org/licenses/MIT)
[](https://nextjs.org/)
[](https://supabase.com)
[](https://www.typescriptlang.org/)
[](CONTRIBUTING.md)
A modern, open-source Point of Sale system built with Next.js and Supabase.
[Demo](#demo) •
[Features](#features) •
[Installation](#installation) •
[Documentation](#documentation) •
[Contributing](#contributing) •
[License](#license)
## 📋 Overview
ZenPOS is a comprehensive Point of Sale solution designed for small to medium-sized businesses. It provides an intuitive interface for managing products, tracking sales, and generating reports. Built with modern web technologies, ZenPOS offers a responsive design that works seamlessly on both desktop and mobile devices.
## ✨ Features
- **User Management** - Secure authentication and role-based access control
- **Product Catalog** - Easy-to-use product management with categories and inventory tracking
- **Transaction Processing** - Smooth and intuitive sales transaction workflow
- **Analytics Dashboard** - Comprehensive sales reports and data visualization
- **Responsive Design** - Works on desktop, tablet, and mobile devices
- **Offline Support** - Continue operations during internet disruptions
## 🖼️ Screenshots
Dashboard - Analytics and business overview
Cashier - Point of sale interface
## 🛠️ Tech Stack
- **Frontend**
- [Next.js](https://nextjs.org) - React framework
- [TypeScript](https://www.typescriptlang.org/) - Type safety
- [Tailwind CSS](https://tailwindcss.com) - Styling
- [shadcn/ui](https://ui.shadcn.com) - UI components
- [Recharts](https://recharts.org) - Data visualization
- **Backend**
- [Supabase](https://supabase.com) - Backend as a Service
- PostgreSQL - Database
- Row Level Security - Data protection
## 🚀 Installation
### Prerequisites
- Node.js 18.0 or higher
- npm, yarn, or pnpm
- Supabase account
### Setup
1. **Clone the repository**
```bash
git clone https://github.com/zidanhafiz/zenpos.git
cd zenpos
```
2. **Install dependencies**
```bash
npm install
# or
yarn install
# or
pnpm install
```
3. **Set up environment variables**
```bash
cp .env.example .env.local
```
Edit `.env.local` with your Supabase project details.
4. **Set up the database**
```bash
npm run setup-db
# or
yarn setup-db
# or
pnpm setup-db
```
See [Database Setup](docs/DATABASE_SETUP.md) for detailed instructions.
5. **Start the development server**
```bash
npm run dev
# or
yarn dev
# or
pnpm dev
```
6. **Open [http://localhost:3000](http://localhost:3000)** in your browser.
## 📖 Documentation
- [Database Setup Guide](docs/DATABASE_SETUP.md)
- [API Documentation](docs/API.md) (coming soon)
- [User Guide](docs/USER_GUIDE.md) (coming soon)
- [Deployment Guide](docs/DEPLOYMENT.md) (coming soon)
## 🤝 Contributing
Contributions are welcome and appreciated! Here's how you can contribute:
1. **Fork the repository**
2. **Create a feature branch**
```bash
git checkout -b feature/amazing-feature
```
3. **Commit your changes**
```bash
git commit -m 'Add some amazing feature'
```
4. **Push to the branch**
```bash
git push origin feature/amazing-feature
```
5. **Open a Pull Request**
Please read our [Contributing Guidelines](CONTRIBUTING.md) (coming soon) for details.
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 💬 Support
If you encounter any issues or have questions:
- [Open an Issue](https://github.com/zidanhafiz/zenpos/issues/new)
- [Start a Discussion](https://github.com/zidanhafiz/zenpos/discussions)
## 🔗 Links
- [Next.js Documentation](https://nextjs.org/docs)
- [Supabase Documentation](https://supabase.com/docs)
- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
---
Made with ❤️ by [Zidan Hafiz](https://github.com/zidanhafiz)