TopService

A fast, single-page marketing website for TopService, a specialized washing-machine repair business operating in Pakdasht, Iran. Built with React + Vite, fully in Persian (RTL).

🔗 Live site: toopservice 📦 Repository: github.com/amirhamidi2001/topservice

Overview

The site presents the business's services, featured repairs, technician expertise, customer testimonials, and contact information — all on a single scrolling page with smooth anchor navigation. It's built to be lightweight, fast on mobile, and easy to maintain.

Features

• 🖥️ Fully responsive layout, tuned for real mobile breakpoints (320–768px) as well as tablet and desktop
• 🔁 RTL-first design and typography for Persian content
• 🎞️ Scroll-triggered entrance animations via AOS
• 🎠 Testimonials carousel via Swiper, code-split and lazy-loaded to keep the initial bundle small
• 🔍 SEO-ready: meta tags, Open Graph / Twitter cards, robots.txt, sitemap.xml, and JSON-LD LocalBusiness schema
• ♿ Accessible markup: semantic headings, aria-* attributes on interactive elements, descriptive alt text
• ⚡ Optimized production build with vendor code-splitting and lazy-loaded images

Tech Stack

Framework	React 19
Build tool	Vite
Styling	Tailwind CSS
Animations	AOS
Carousel	Swiper
Linting	ESLint

Project Structure

topservice/                  # repo root
├── LICENSE
├── README.md                # you are here
└── topservice/               # the React + Vite application
    ├── public/
    │   ├── assets/img/       # static images
    │   ├── favicon.ico, apple-touch-icon.png
    │   └── robots.txt, sitemap.xml, ads.txt
    ├── src/
    │   ├── components/       # one component per page section
    │   │   ├── Header.jsx
    │   │   ├── Hero.jsx
    │   │   ├── About.jsx
    │   │   ├── FeaturedProperties.jsx
    │   │   ├── FeaturedServices.jsx
    │   │   ├── Testimonials.jsx
    │   │   ├── WhyUs.jsx
    │   │   ├── CallToAction.jsx
    │   │   ├── ContactInfo.jsx
    │   │   └── Footer.jsx
    │   ├── data/
    │   │   └── content.js    # static content (nav links, services, testimonials, etc.)
    │   ├── App.jsx
    │   ├── main.jsx
    │   └── index.css
    ├── index.html
    ├── tailwind.config.js
    ├── vite.config.js
    └── package.json

Getting Started

Prerequisites

• Node.js 18+
• npm (or another package manager of your choice)

Installation

git clone https://github.com/amirhamidi2001/topservice.git
cd topservice/topservice
npm install

Development

npm run dev

Starts the Vite dev server with hot module replacement, typically at http://localhost:5173.

Production Build

npm run build

Outputs an optimized, production-ready build to dist/.

npm run preview

Serves the dist/ build locally to preview it before deploying.

Linting

npm run lint

Deployment

npm run build produces a fully static site (dist/), so it can be deployed to any static host — Vercel, Netlify, GitHub Pages, or a plain Nginx/Apache server. No server-side runtime is required. The live site is deployed at toopservice.

Contact

For business inquiries related to TopService, use the contact section on toopservice.

License

This project is licensed under the MIT License — see LICENSE for details.