59 lines
2.5 KiB
Markdown
59 lines
2.5 KiB
Markdown
# Masar NDT - Inspection, NDT & Asset-Integrity Engineering
|
|
|
|
Welcome to the official repository of **Masar NDT**, a highly polished, interactive web application presenting specialized Non-Destructive Testing (NDT) services, asset integrity portfolios, and engineering insights.
|
|
|
|
This codebase is ready for deployment and local evaluation.
|
|
|
|
---
|
|
|
|
## 🛠️ Tech Stack & Key Technologies
|
|
|
|
- **Frontend Library:** React 18
|
|
- **Build Tool & Dev Server:** Vite
|
|
- **Styling:** Tailwind CSS (utility-first, modern responsive grid layouts)
|
|
- **Animations & Transitions:** Framer Motion (smooth route and interactive menu transitions)
|
|
- **Icons:** Lucide React
|
|
- **Language:** TypeScript/JavaScript (clean ES modules)
|
|
|
|
---
|
|
|
|
## ✨ Key Features Included
|
|
|
|
- **Dynamic Services Explorer:** Full technical breakdown of Advanced NDT (Phased Array, TOFD, Tube Inspection), Conventional NDT, and Specialized Asset Integrity assessments.
|
|
- **Staggered Process Roadmap:** An elegant interactive walkthrough of our end-to-end inspection workflow from pre-planning to field execution and automated reporting.
|
|
- **Team & Author Portfolios:** High-quality profile presentations of our international leadership team, including Engr. Tariq Al-Ghamdi and Dr. S. K. Al-Qahtani.
|
|
- **Fully Responsive Navigation:** Optimized mobile layout with a slide-out navigation overlay that overlays perfectly on top of active screens without jumping.
|
|
- **Quote Request Hub:** Integrated contact gateway allowing clients to prompt custom RFQs directly for critical turnaround programs.
|
|
|
|
---
|
|
|
|
## 🚀 Getting Started
|
|
|
|
Ensure you have [Node.js](https://nodejs.org/) (v18 or higher) installed on your system.
|
|
|
|
### 1. Install Dependencies
|
|
In the root directory of the project, run the following command to download and set up all required NPM packages:
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
### 2. Start the Local Development Server
|
|
Launch the hot-reloading development server to preview and test changes:
|
|
```bash
|
|
npm run dev
|
|
```
|
|
Once started, open your browser and navigate to the local address displayed in your terminal (usually `http://localhost:3000` or similar).
|
|
|
|
### 3. Static Production Build
|
|
Compile and bundle the production-ready static assets:
|
|
```bash
|
|
npm run build
|
|
```
|
|
This will compile the codebase and produce optimized, minified files inside the `/dist` directory, ready to be hosted on any high-performance static server or CDN.
|
|
|
|
### 4. Code Quality & Linting
|
|
Run static analysis checks to verify standard styling and syntax integrity:
|
|
```bash
|
|
npm run lint
|
|
```
|