{"id":30856766,"url":"https://github.com/rafirabby13/parcel-delivery-system-frontend","last_synced_at":"2026-05-02T23:44:19.454Z","repository":{"id":310888818,"uuid":"1041580538","full_name":"rafirabby13/parcel-delivery-system-frontend","owner":"rafirabby13","description":"Parcelo streamlines the entire parcel delivery lifecycle with separate interfaces for senders, receivers, delivery personnel, and administrators. The platform provides real-time tracking, automated pricing calculation, secure payment processing, and comprehensive delivery management tools.","archived":false,"fork":false,"pushed_at":"2026-01-19T15:01:04.000Z","size":2993,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-02T23:43:49.573Z","etag":null,"topics":["hyperui","originui","reactjs","redux-toolkit","shadcn-ui","tailwindcss","typescript","zod-validation"],"latest_commit_sha":null,"homepage":"https://parcel-delivery-system-frontend-iota.vercel.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rafirabby13.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-20T17:42:04.000Z","updated_at":"2025-12-22T06:06:34.000Z","dependencies_parsed_at":"2025-08-20T21:38:38.267Z","dependency_job_id":"50b0a39c-5cdc-4b79-9124-7e347bc7f4fe","html_url":"https://github.com/rafirabby13/parcel-delivery-system-frontend","commit_stats":null,"previous_names":["rafirabby13/parcel-delivery-system-frontend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rafirabby13/parcel-delivery-system-frontend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafirabby13%2Fparcel-delivery-system-frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafirabby13%2Fparcel-delivery-system-frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafirabby13%2Fparcel-delivery-system-frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafirabby13%2Fparcel-delivery-system-frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rafirabby13","download_url":"https://codeload.github.com/rafirabby13/parcel-delivery-system-frontend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafirabby13%2Fparcel-delivery-system-frontend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32553690,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T22:28:24.418Z","status":"ssl_error","status_checked_at":"2026-05-02T22:28:14.225Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hyperui","originui","reactjs","redux-toolkit","shadcn-ui","tailwindcss","typescript","zod-validation"],"created_at":"2025-09-07T12:10:16.797Z","updated_at":"2026-05-02T23:44:19.426Z","avatar_url":"https://github.com/rafirabby13.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 📦 Parcelo - Parcel Delivery Management System\n\n\n\nA comprehensive, full-stack parcel delivery and tracking platform designed for modern logistics operations across Bangladesh. Built with React, TypeScript, and a robust backend architecture to handle everything from parcel booking to real-time delivery tracking.\n\n# Live Site\n\n## https://parcel-delivery-system-frontend-iota.vercel.app/\n\n## Features\n\n### 🔐 Authentication \u0026 Authorization\n\n- Role-based access control (Sender, Receiver, Delivery Partner, Super Admin)\n- Secure JWT authentication\n- Password visibility toggle\n- Form validation with Zod\n\n### 📋 Parcel Management\n\n- Create Parcel: Comprehensive form with sender/receiver details\n- Track Parcel: Public tracking with real-time - status updates\n- Status Updates: Delivery partner interface for status management\n- Payment Integration: Multiple payment methods (Prepaid, Postpaid, COD)\n### 🔒 Security Features\n\n- JWT Authentication with secure token storage\n- Role-based Access Control (RBAC)\n- Input Validation on client and server\n\n### 📱 Responsive Design\n\nThe application is fully responsive and optimized for:\n\n- 📱 Mobile devices (320px+)\n- 📱 Tablets (768px+)\n- 💻 Desktop (1024px+)\n- 🖥️ Large screens (1440px+)\n### 🚚 Delivery Operations\n\n- Delivery partner assignment\n- Real-time status tracking\n- Complete delivery timeline\n- Mobile-responsive design for field operations\n\n### 🎨 Modern UI/UX\n\n- Beautiful gradient designs with glassmorphism effects\n- Responsive design for all devices\n- Dark mode support\n- Smooth animations and transitions\n- Professional color-coded interfaces\n\n### 🌙 Dark Mode Support\n\nFull dark mode implementation with:\n\n- System preference detection\n- Manual toggle option\n- Persistent user preference\n- Smooth transitions\n### 🌍 Bangladesh-Specific Features\n\n- Bangladesh phone number validation (01[3-9]XXXXXXXX)\n- Division, city, and area management\n- Currency display in BDT (৳)\n- Local date/time formatting\n## Installation\n\n### 1. Clone the repository\n\n```bash\ngit clone https://github.com/your-username/parcel-delivery-system.git\ncd parcel-delivery-system\n```\n### 2. Install dependencies\n\n\n```bash\nnpm install\n   # or\nyarn install\n```\n### 3. Environment Setup\n\n\n```bash\ncp .env.example .env.local\nVITE_API_BASE_URL=http://localhost:5000/api\nVITE_APP_NAME=Parcel Delivery System\n```\n### 4. Start development server\n\n\n```bash\nnpm run dev\n# or\nyarn dev\n```\n### 5. Open your browser\n\n\n```bash\nhttp://localhost:5173\n```\n    \n## 📁 Project Structure\n\n\n```\n├─ src/\n│  ├─ assets/\n│  │  ├─ icons/\n│  │  ├─ images/\n│  │  └─ react.svg\n│  ├─ components/\n│  │  ├─ layout/\n│  │  │  ├─ CommonLayout.tsx\n│  │  │  ├─ DashboardLayout.tsx\n│  │  │  ├─ Footer.tsx\n│  │  │  └─ Navbar.tsx\n│  │  ├─ modules/\n│  │  │  ├─ admin/\n│  │  ├─ ui/\n│  ├─ config/\n│  │  └─ index.env.ts\n│  ├─ constants/\n│  │  └─ role.ts\n│  ├─ context/\n│  ├─ formValidationSchema/\n│  │  └─ parcel.schema.ts\n│  ├─ hooks/\n│  ├─ lib/\n│  ├─ pages/\n│  │  ├─ admin/\n│  │  ├─ receiver/\n│  │  ├─ sender/\n│  │  └─ VerifyUser.tsx\n│  ├─ redux/\n│  │  ├─ feature/\n│  │  │  ├─ auth/\n│  │  │  │  └─ auth.api.ts\n│  │  ├─ axiosBaseQuery.ts\n│  │  ├─ baseApi.ts\n│  │  ├─ hook.ts\n│  │  └─ store.ts\n│  ├─ routes/\n│  ├─ types/\n│  ├─ utils/\n│  ├─ App.tsx\n│  ├─ index.css\n│  ├─ main.tsx\n```\n\n## Tech Stack\n\n### Frontend\n\n*  React 18 : Modern React with hooks\n*  TypeScript - Type safety and better DX\n*  Vite - Fast build tool and dev server\n*  Tailwind CSS - Utility-first CSS framework\n*  shadcn/ui - High-quality component library\n\n### State Management\n\n*  Redux Toolkit - Modern Redux with less boilerplate\n*  RTK Query - Data fetching and caching\n\n### Form Management\n\n*  React Hook Form - Performant forms with easy validation\n*  Zod - TypeScript-first schema validation\n\n### UI/UX\n\n*  Lucide React - Beautiful icon library\n*  Sonner - Modern toast notifications\n*  Framer Motion - Smooth animations (optional)\n\n### Development\n\n*  ESLint - Code linting\n*  Prettier - Code formatting\n*  Husky - Git hooks\n*  Lint-staged - Run linters on staged files\n\n\n## 🔧 Available Scripts\n\nTo run tests, run the following command\n\n```bash\n# Development\nnpm run dev          # Start development server\nnpm run build        # Build for production\nnpm run preview      # Preview production build\n\n# Code Quality\nnpm run lint         # Run ESLint\nnpm run lint:fix     # Fix ESLint errors\nnpm run format       # Format code with Prettier\nnpm run type-check   # Run TypeScript compiler\n\n# Testing\nnpm run test         # Run tests\nnpm run test:watch   # Run tests in watch mode\nnpm run test:coverage # Generate test coverage\n```\n\n\n##  🎨 Component Examples\n\n### Create Parcel Form\n\n```typescript\nimport { CreateTour } from '@/components/forms/CreateTour'\n\n// Usage\n\u003cCreateTour \n  onSuccess={(parcel) =\u003e console.log('Parcel created:', parcel)}\n  className=\"max-w-4xl mx-auto\"\n/\u003e\n```\n### Track Parcel\n\n\n```typescript\nimport { TrackParcel } from '@/components/tracking/TrackParcel'\n\n// Usage - Public route, no auth required\n\u003cTrackParcel /\u003e\n```\n### Status Update Interface\n\n```typescript\nimport { UpdateStatus } from '@/components/delivery/UpdateStatus'\n\n// Usage - For delivery partners\n\u003cUpdateStatus \n  parcels={assignedParcels}\n  onStatusUpdate={handleStatusUpdate}\n/\u003e\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafirabby13%2Fparcel-delivery-system-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frafirabby13%2Fparcel-delivery-system-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafirabby13%2Fparcel-delivery-system-frontend/lists"}