https://github.com/o2sa/surf-logistics-inc
Website with dashboard for shipping company with supporting for english and franch using mern stack
https://github.com/o2sa/surf-logistics-inc
express jspdf localization mantine mantine-react-table mern-stack mongo nodejs react tawk-integration
Last synced: 3 months ago
JSON representation
Website with dashboard for shipping company with supporting for english and franch using mern stack
- Host: GitHub
- URL: https://github.com/o2sa/surf-logistics-inc
- Owner: O2sa
- Created: 2024-09-08T17:35:11.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-15T21:54:54.000Z (over 1 year ago)
- Last Synced: 2025-02-08T07:13:20.732Z (over 1 year ago)
- Topics: express, jspdf, localization, mantine, mantine-react-table, mern-stack, mongo, nodejs, react, tawk-integration
- Language: JavaScript
- Homepage: https://surf-logistics.onrender.com
- Size: 215 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📦 Logistics & Shipping Platform (MERN)
A comprehensive web solution for a shipping and logistics company. This project includes a pixel-perfect public-facing website based on a specific design and a robust admin dashboard for managing client interactions.
### 🚀 Key Features
**🌐 Public Website (Client Side)**
* **Multi-Page Layout:** Fully responsive design implementing a professional UI kit.
* **Internationalization (i18n):** Full support for **English** and **French**, allowing users to toggle languages seamlessly.
* **Real-time Support:** Integrated **Tawk.to** widget for live customer messaging and support.
* **Service Showcase:** Detailed pages for shipping services, tracking, and company information.
**🛠 Admin Dashboard**
* **Request Management:** Centralized hub for admins to view and manage consulting and meeting requests submitted by clients.
* **Secure Authentication:** Protected routes for administrative access.
### 🛠️ Tech Stack
* **Frontend:** React.js, Mantine UI (for styling and components)
* **Backend:** Node.js, Express.js
* **Database:** MongoDB
* **Tools:** Tawk.to (Chat), i18next (Localization)
### 🔧 Installation & Setup
**Clone the repository**
```bash
git clone https://github.com/O2sa/Surf-Logistics-Inc.git
```
#### Run it with docker
##### **Run this command in the root of the project**:
```bash
docker compose up -d
```
#### Without docker
1. **Install Dependencies (Root/Backend)**
```bash
cd server
npm install
```
2. **Install Dependencies (Frontend)**
```bash
cd client
npm install
```
3. **Environment Variables**
- Paste the following content into the `.env` file, replacing the placeholders with your actual values:
```
MONGO_URL=mongodb://localhost:27017/final_surf
JWT_SECRET=YOUR_JWT_SECRET
JWT_LIFETIME=30d
NODE_ENV=production
PORT=5000
```
4. **Run the App**
```bash
// run this command in the client and the server
npm run dev
```