Sosoliso Energy - LPG Ordering Platform

A modern web application for LPG ("cooking gas") sales and distribution across Nigeria, powered by the Soso Credits wallet system.

Features

• User Registration & Soso Credits Wallet
• LPG Catalogue & Purchases
• Points & Referral System
• Order Management
• Delivery Management with Secure Confirmation
• Enterprise Support Program
• Community Forum & Customer Support

Tech Stack

• Next.js 14 (App Router)
• TypeScript
• Tailwind CSS
• Prisma (Database ORM)
• NextAuth.js (Authentication)
• React Query (Data Fetching)
• React Hook Form (Form Management)
• Zod (Schema Validation)

Getting Started

1. Clone the repository
2. Install dependencies:

   npm install

3. Set up environment variables:

   cp .env.example .env.local

4. Initialize the database:

   npx prisma db push

5. Run the development server:

   npm run dev

Environment Variables

Create a .env.local file with the following variables:

DATABASE_URL="your-database-url"
NEXTAUTH_SECRET="your-nextauth-secret"
NEXTAUTH_URL="http://localhost:3000"

Project Structure

src/
├── app/                 # App router pages
├── components/         # Reusable components
├── lib/               # Utility functions and configurations
├── prisma/            # Database schema and migrations
└── types/             # TypeScript type definitions

Contributing

1. Create a feature branch
2. Make your changes
3. Submit a pull request

License

MIT