Skip to content

yusuf-mahran/kaaba

Repository files navigation

Kaaba - Premium Hajj & Umrah

Premium Hajj & Umrah journeys with curated packages, trusted guidance, and seamless planning.

A high-performance, responsive landing page that helps pilgrims discover and book their sacred journey with confidence.

Next.js TypeScript Tailwind CSS React Framer Motion License: MIT


✨ Why Kaaba?

Planning a Hajj or Umrah trip is a deeply personal and complex endeavor. Kaaba provides a clean, focused experience that lets pilgrims:

  • Browse curated packages — from Comfort to Elite, with transparent pricing
  • Compare travel options at a glance with feature-rich cards
  • Book confidently with a trusted, well-designed interface
  • Get inspired through a rich gallery and community stats

Whether you're a first-time pilgrim or a returning visitor, Kaaba cuts through the noise and gets you to what matters.

Kaaba - Hajj & Umrah Landing Page

🚀 Quick Start

pnpm install
pnpm run build
pnpm run dev

Open http://localhost:3000 to view the site.


🛠️ Tech Stack

Layer Technology
Framework Next
Language TypeScript
Styling Tailwind CSS
Animation Framer Motion
Date Handling date-fns React Day Picker
Icons React Icons
Notifications React Toastify

📦 Packages Offered

Package Price Highlights
Comfort $900–$1,800/person 3-star hotel, daily breakfast, guided tours
Premium $1,200–$2,400/person 4-star hotel, breakfast & dinner, transfers
Elite $2,000–$4,000/person Business class, 5-star hotel, all meals, private transfers

Group discounts available: 40% off for 2+ persons on 4+ nights.


📂 Project Structure

components/       UI sections (Hero, About, Packages, Gallery, etc.)
├── utils/        Reusable atoms (Button, Logo, DateRangePicker, etc.)
data/             Static content (packages, partners)
lib/              Design system tokens
public/           Static assets (images, gallery, posters)
src/app/          Next.js App Router (layout, page, globals)

🏗️ Getting Started (Full Guide)

Prerequisites

  • Node.js ≥ 18
  • pnpm ≥ 9

Installation

git clone https://github.com/yusuf-mahran/kaaba.git
cd kaaba
pnpm install

Development

pnpm dev

Production Build

pnpm build
pnpm start

Lint

pnpm lint

📄 Key Files


🤝 Contributing

Contributions, issues, and feature requests are welcome!

  1. Fork the repository
  2. Create your branch: git checkout -b feat/your-feature
  3. Commit your changes: git commit -m "feat: add your feature"
  4. Push to the branch: git push origin feat/your-feature
  5. Open a Pull Request

Please use specific git add <file> commands rather than git add . to keep commits clean.


🛡️ Security

If you discover a security vulnerability, please open a GitHub Issue or reach out privately. Do not disclose it publicly until it has been addressed.


📝 License

This project is licensed under the MIT License.


💬 Support

  • Open an Issue for bugs or feature requests
  • Start a Discussion for questions and ideas

Made with ❤️ for every pilgrim's sacred journey

About

KAABA - Premium Hajj & Umrah journeys with curated packages, trusted guidance, and seamless planning.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors