EmkayMaster/v0-south-african-pos-app

# SA Business POS System A comprehensive Point of Sale system built for South African businesses with GAAP compliance and VAT management. ## Features - **Sales Recording** - Quick sales entry with preset items and discount support - **Financial Management** - Cash flow tracking and accounts receivable - **Accounting** - GAAP compliant trial balance and VAT returns - **Reports & Analytics** - Comprehensive business reporting - **Settings Management** - Preset items, VAT rates, and business configuration - **Role-Based Access** - Admin, Manager, and Cashier roles with appropriate permissions ## Tech Stack - **Frontend**: Next.js 14, React, TypeScript, Tailwind CSS - **UI Components**: shadcn/ui - **Authentication**: JWT-based with role-based access control - **State Management**: React Context API - **Styling**: Tailwind CSS with custom components ## Getting Started ### Prerequisites - Node.js 18+ - npm or yarn ### Installation 1. Clone the repository: \`\`\`bash git clone github.com cd sa-business-pos \`\`\` 2. Install dependencies: \`\`\`bash npm install \`\`\` 3. Run the development server: \`\`\`bash npm run dev \`\`\` 4. Open localhost in your browser. ### Demo Accounts - **Admin**: username: `admin`, password: `password` - **Manager**: username: `manager`, password: `password` - **Cashier**: username: `cashier`, password: `password` ## Project Structure \`\`\` ├── app/ # Next.js app directory ├── components/ # React components │ ├── ui/ # shadcn/ui components │ ├── auth-context.tsx # Authentication context │ ├── login-form.tsx # Login component │ └── ... # Feature components ├── hooks/ # Custom React hooks ├── lib/ # Utility functions └── public/ # Static assets \`\`\` ## Key Features ### Authentication & Authorization - JWT-based authentication - Role-based access control (Adm …