react-it-solutions-agency-template — React Business Template

SHA-256: 1e70e534fb19df901444c819accf7b14cac8683b6bc70a674caad2b46eb9d1b5

2026-10-02T15:18:45.873Z

# MVPier - IT Solutions Agency Template

<div align="center">
  <img src="./public/mvpier_hero.png" alt="MVPier Hero" width="100%" />
  
  <p align="center">
    <strong>A modern, free and open-source React template for IT solutions agencies</strong>
  </p>
  
  <p align="center">
    Build your MVP faster and easier with this beautiful, fully-responsive template
  </p>

  <p align="center">
    <a href="https://mvpier.netlify.app/" target="_blank">Live Demo</a> •
    <a href="#features">Features</a> •
    <a href="#installation">Installation</a> •
    <a href="#usage">Usage</a> •
    <a href="#license">License</a>
  </p>
</div>

---

## Table of Contents

- [Demo](#demo)
- [About](#about)
- [Features](#features)
- [Tech Stack](#tech-stack)
- [Getting Started](#getting-started)
  - [Prerequisites](#prerequisites)
  - [Installation](#installation)
- [Usage](#usage)
- [Project Structure](#project-structure)
- [Customization](#customization)
- [Deployment](#deployment)
- [Contributing](#contributing)
- [License](#license)
- [Author](#author)

## Demo

**[View Live Demo →](https://mvpier.netlify.app/)**

Experience the template in action! The live demo showcases all features, components, and pages included in this template.

## About

**MVPier** is a professional, modern, and fully-responsive React template designed specifically for IT solutions agencies, startups, and tech companies. Built with the latest web technologies, this template helps you create a stunning online presence quickly and efficiently.

Whether you're launching a new agency, showcasing your services, or building an MVP for your tech business, MVPier provides all the essential components and pages you need to get started immediately.

## Features

- **Modern & Beautiful Design** - Clean, professional UI with smooth animations
- **Fully Responsive** - Optimized for all devices and screen sizes
- **Lightning Fast** - Built with Vite for blazing-fast performance
- **Smooth Animations** - Powered by Framer Motion for fluid interactions
- **SEO Optimized** - Meta tags and semantic HTML for better search rankings
- **Tailwind CSS** - Utility-first CSS framework for easy customization
- **Modular Components** - Reusable and well-organized component structure
- **Multiple Pages** - Home, About, Services, Portfolio, Team, Contact, and more
- **TypeScript** - Type-safe code for better development experience
- **Easy to Customize** - Well-documented and easy to modify
- **Lottie Animations** - Engaging vector animations
- **Newsletter Integration** - Built-in newsletter signup component
- **Testimonials Section** - Showcase client feedback
- **Call-to-Action Sections** - Convert visitors into clients

## Tech Stack

- **[React 18](https://react.dev/)** - Modern React with hooks
- **[TypeScript](https://www.typescriptlang.org/)** - Type-safe JavaScript
- **[Vite](https://vitejs.dev/)** - Next-generation frontend tooling
- **[Tailwind CSS](https://tailwindcss.com/)** - Utility-first CSS framework
- **[Framer Motion](https://www.framer.com/motion/)** - Production-ready animation library
- **[React Router](https://reactrouter.com/)** - Client-side routing
- **[Lucide React](https://lucide.dev/)** - Beautiful & consistent icons
- **[Lottie React](https://www.npmjs.com/package/lottie-react)** - Render Adobe After Effects animations
- **[ESLint](https://eslint.org/)** - Code linting and quality

## Getting Started

### Prerequisites

Before you begin, ensure you have the following installed:

- **Node.js** (version 16 or higher)
- **npm** or **yarn** or **pnpm**

### Installation

1. **Clone the repository**

```bash
git clone https://github.com/fedilayoub/react-it-solutions-agency-template.git
cd mvpier
```

2. **Install dependencies**

```bash
npm install
# or
yarn install
# or
pnpm install
```

3. **Start the development server**

```bash
npm run dev
# or
yarn dev
# or
pnpm dev
```

4. **Open your browser**

Navigate to `http://localhost:5173` to see your app running.

## Usage

### Available Scripts

- `npm run dev` - Start development server
- `npm run build` - Build for production
- `npm run build:dev` - Build in development mode
- `npm run preview` - Preview production build locally
- `npm run lint` - Run ESLint to check code quality

### Building for Production

```bash
npm run build
```

The optimized production files will be in the `dist` directory.

## Project Structure

```
mvpier/
├── public/                 # Static assets
│   ├── mvpier_hero.png    # Hero image
│   ├── mvpier_logo.svg    # Logo files
│   └── ...                # Other images and assets
├── src/
│   ├── components/        # Reusable React components
│   │   ├── Navbar.tsx
│   │   ├── Hero.tsx
│   │   ├── Features.tsx
│   │   ├── Testimonials.tsx
│   │   ├── Footer.tsx
│   │   └── ...
│   ├── pages/            # Page components
│   │   ├── Index.tsx     # Home page
│   │   ├── About.tsx
│   │   ├── Services.tsx
│   │   ├── Portfolio.tsx
│   │   ├── Team.tsx
│   │   ├── Contact.tsx
│   │   └── ...
│   ├── hooks/            # Custom React hooks
│   ├── lib/              # Utility functions
│   ├── App.tsx           # Main app component
│   ├── main.tsx          # Entry point
│   └── index.css         # Global styles
├── index.html
├── package.json
├── tailwind.config.ts    # Tailwind configuration
├── vite.config.ts        # Vite configuration
└── tsconfig.json         # TypeScript configuration
```

## Customization

### Changing Colors

Edit `tailwind.config.ts` to customize the color scheme:

```typescript
export default {
  theme: {
    extend: {
      colors: {
        // Add your custom colors here
      }
    }
  }
}
```

### Updating Content

1. **Logo & Branding**: Replace logo files in `public/` directory
2. **Images**: Add your images to `public/` folder
3. **Text Content**: Edit component files in `src/components/` and `src/pages/`
4. **Meta Tags**: Update `index.html` for SEO

### Adding New Pages

1. Create a new component in `src/pages/`
2. Add the route in `src/App.tsx`

```typescript
<Route path="/your-page" element={<YourPage />} />
```

## Deployment

### Deploying to Vercel

1. Push your code to GitHub
2. Import your repository on [Vercel](https://vercel.com)
3. Deploy with one click

### Deploying to Netlify

1. Push your code to GitHub
2. Connect your repository on [Netlify](https://netlify.com)
3. Build command: `npm run build`
4. Publish directory: `dist`

### Deploying to GitHub Pages

```bash
npm run build
# Deploy the dist folder to GitHub Pages
```

## Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## License

This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.

This means you are free to:
- Use commercially
- Modify
- Distribute
- Private use

## Author

**Fedil Ayoub**

- GitHub: [@fedilayoub](https://github.com/fedilayoub)

## Acknowledgments

- [React](https://react.dev/)
- [Vite](https://vitejs.dev/)
- [Tailwind CSS](https://tailwindcss.com/)
- [Framer Motion](https://www.framer.com/motion/)
- [Lucide Icons](https://lucide.dev/)

---

<div align="center">
  <p>Made with love by Fedil Ayoub</p>
  <p>If you find this template helpful, please give it a star</p>
</div>