Skip to content
This repository was archived by the owner on Sep 18, 2026. It is now read-only.
basgenix4uPublic archive

About

Fuel availability and station-support platform concept for helping users discover and manage fuel access information.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

⛽ FuelLink

A fuel availability and station-support platform — helping users, marketers, depot operators, and drivers coordinate fuel information, pricing insights, and logistics workflows.

Next.js TypeScript Tailwind CSS Recharts License: MIT

👤 Author: Abdulbasit Abdulalim


✨ Overview

FuelLink is a client-ready product concept for the fuel and logistics sector. It includes role-based dashboards, live-style fuel price and refinery/depot UI, fleet request workflows, marketer tools, and data visualisation — all through a modern web interface.


🚀 Key Features

  • Public landing page for the platform
  • Role-based app areas for admin, depot, driver, and marketer users
  • Depot / refinery ticker components
  • Fuel price and fleet request UI concepts
  • Marketer calculator tools
  • Price alert interaction components
  • Chat window component
  • QR code support
  • Recharts-powered dashboard visualisations
  • Zustand state management
  • Reusable shared design-system components
  • Fully responsive Next.js interface

🛠 Tech Stack

Area Technology
Framework Next.js, React
Language TypeScript
Styling Tailwind CSS
UI Radix UI, Lucide Icons, Framer Motion
Charts Recharts
State Zustand
Utilities date-fns, qrcode.react
Deployment Vercel

📁 Project Structure

src/app/                 App routes, landing page and role-based dashboard areas
src/components/          Landing, depot, marketer and shared UI components
src/lib/                 Utilities, mock data and store setup
src/types/               TypeScript types
public/                  Static assets

⚡ Getting Started

git clone https://github.com/basgenix4u/fuelLink.git
cd fuelLink
npm install
npm run dev

Open http://localhost:3000.


📜 Available Scripts

Command Description
npm run dev Start the local development server
npm run build Build the production app
npm run start Start the production server
npm run lint Run ESLint

📦 Product Modules

Module Purpose
Admin Central control area for platform monitoring and operational visibility
Depot Depot / refinery interface for supply and availability updates
Driver Driver-focused route and workflow experience concept
Marketer Marketer tools — calculator, fleet requests, alerts, pricing UI

🗺 Roadmap

  • Add real authentication and role-based access control
  • Connect to a backend API and production database

📄 License

Released under the MIT License.


About

Fuel availability and station-support platform concept for helping users discover and manage fuel access information.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages