IHST Group - International House of Sciences Tunisia

About This Project

IHST Group is a premier educational and business consultancy in Tunisia, established in 2021. This platform serves as a comprehensive portal for both our business consulting and educational services.

Created By

Mohamed Zwanski

Key Features

• Dual-focused platform serving both business and educational needs
• Business Consulting Services for organizations and entrepreneurs
• Educational Programs including tutoring and resources for students
• Multi-user Portal System with specialized dashboards for:
  • Administrators
  • Parents
  • Students
• Responsive design that works across desktop and mobile devices
• Multilingual Support with English, French, and Arabic options

Tech Stack

This project is built with modern web technologies:

• Vite
• TypeScript
• React
• shadcn-ui
• Tailwind CSS
• Supabase (authentication and database)
• React Query for data fetching
• React Router for navigation
• React Hook Form for form handling

Getting Started

Prerequisites

• Node.js 18.0 or higher
• npm 8.0 or higher

Installation

# Step 1: Clone the repository
git clone <REPOSITORY_URL>

# Step 2: Navigate to the project directory
cd ihst-group

# Step 3: Install dependencies
npm i

# Step 4: Start the development server
npm run dev

Testing

The project includes a comprehensive test suite for components and hooks:

# Run all tests
npm test

# Run tests with coverage report
npm test -- --coverage

Project Structure

• /src/pages/ishtgroup - Business consulting section
• /src/pages/tutoring - Educational services section
• /src/pages/admin - Administrator portal
• /src/pages/parent - Parent dashboard
• /src/components - Reusable UI components
• /src/contexts - React context providers (auth, theme, language)
• /src/hooks - Custom React hooks
• /src/lib - Utility functions and services
• /src/__tests__ - Test files

Contributing

We welcome contributions from anyone interested in improving this platform! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

How to Contribute

1. Fork the repository
2. Create a new branch for your feature
3. Make your changes
4. Submit a pull request

Please ensure your code follows the existing style and includes appropriate tests.

Code Quality Standards

• All new code should have corresponding tests
• Maintain code coverage above 80%
• Follow the TypeScript best practices
• Use the existing component patterns

Deployment

The project can be deployed using the following methods:

• Through Lovable by clicking Share -> Publish
• Manual deployment to Netlify, Vercel, or other hosting services
• CI/CD pipeline via GitHub Actions

Security

We take security seriously. Please refer to our SECURITY.md file for details on:

• How to report vulnerabilities
• Supported versions
• Security best practices
• Compliance information

Contact

For questions or suggestions regarding this project, please contact:

• Mohamed Zwanski (IT Support)
• IHST Group Team
• [email protected]
• +216 24 225 975

License

This project is available for community contributions while maintaining attribution to the original creator.

---

© 2025 IHST Group. All rights reserved.