{"id":30046664,"url":"https://github.com/codewithdhruba01/comfortpg_website","last_synced_at":"2026-03-09T06:32:42.705Z","repository":{"id":305039192,"uuid":"1021696894","full_name":"codewithdhruba01/ComfortPG_Website","owner":"codewithdhruba01","description":"Complete PG Website with Room Booking System","archived":false,"fork":false,"pushed_at":"2025-10-19T17:44:46.000Z","size":271,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-20T01:10:02.761Z","etag":null,"topics":["react","tailwindcss","typescript","vite"],"latest_commit_sha":null,"homepage":"https://comfort-pg.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codewithdhruba01.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-17T19:53:37.000Z","updated_at":"2025-10-19T17:44:45.000Z","dependencies_parsed_at":"2025-07-18T02:50:50.202Z","dependency_job_id":"9b238e38-fefe-4e83-92a7-8e2daa20610f","html_url":"https://github.com/codewithdhruba01/ComfortPG_Website","commit_stats":null,"previous_names":["codewithdhruba01/comfortpg_website"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codewithdhruba01/ComfortPG_Website","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithdhruba01%2FComfortPG_Website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithdhruba01%2FComfortPG_Website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithdhruba01%2FComfortPG_Website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithdhruba01%2FComfortPG_Website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codewithdhruba01","download_url":"https://codeload.github.com/codewithdhruba01/ComfortPG_Website/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithdhruba01%2FComfortPG_Website/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30284776,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T02:57:19.223Z","status":"ssl_error","status_checked_at":"2026-03-09T02:56:26.373Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["react","tailwindcss","typescript","vite"],"created_at":"2025-08-07T08:47:33.124Z","updated_at":"2026-03-09T06:32:42.686Z","avatar_url":"https://github.com/codewithdhruba01.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n![Banner](public/assets/comfortPG.png)\n\n![GitHub contributors](https://img.shields.io/github/contributors/codewithdhruba01/ComfortPG_Website?color=lightgrey)\n[![GitHub forks](https://img.shields.io/github/forks/codewithdhruba01/ComfortPG_Website?color=lightgrey)](https://github.com/codewithdhruba01/ComfortPG_Website/network)\n[![GitHub stars](https://img.shields.io/github/stars/codewithdhruba01/ComfortPG_Website?color=lightgrey)](https://github.com/codewithdhruba01/ComfortPG_Website/stargazers)\n[![GitHub issues](https://img.shields.io/github/issues/codewithdhruba01/ComfortPG_Website?color=lightgrey)](https://github.com/codewithdhruba01/ComfortPG_Website/issues)\n[![Apache-2.0 License](https://img.shields.io/badge/Apache-2.0license-lightgrey)](./LICENSE)\n\n![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)\n![React](https://img.shields.io/badge/React-20232A?style=for-the-badge\u0026logo=react\u0026logoColor=61DAFB)\n![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-06B6D4?style=for-the-badge\u0026logo=tailwind-css\u0026logoColor=white)\n![Node.js](https://img.shields.io/badge/Node.js-339933?style=for-the-badge\u0026logo=node.js\u0026logoColor=white)\n\n\n\u003c/div\u003e\n\n# ComfortPG - Complete PG Website with Room Booking System\n\nA modern, responsive PG (Paying Guest) accommodation website built with React, TypeScript, and Tailwind CSS. This comprehensive platform provides a complete solution for PG businesses to showcase their properties, manage bookings, and connect with potential residents.\n\n## CONTENTS OF THE FILE\n- [Overview](#comfortpg---complete-pg-website-with-room-booking-system)\n- [Features](#-features)\n- [Configuration](#-configuration)\n- [Installation](#-installation)\n- [Contributing](#-contributing)\n- [License](#-license)\n- [Contributing](#-contributing)\n- [Tech Stack](#️-tech-stack)\n- [Room Management](#room-management)\n- [Home Page](#home-page)\n- [Additional Pages](#additional-pages)\n- [Project Structure](#-project-structure)\n- [Animations \u0026 Interactions](#animations--interactions)\n- [links](#links)\n- [Deployment](#-deployment)\n- [Acknowledgments](#-acknowledgments)\n\n\n\n\n## 🌟 Features\n\n### Core Functionality\n- **Multi-page Website**: Home, Rooms, About, Contact, Privacy Policy, Terms \u0026 Conditions, Funding Information, Partner Us, and FAQ pages\n- **Room Booking System**: Complete room listing, search, filtering, and detailed room pages\n- **Dark/Light Mode**: Seamless theme switching with persistent storage\n- **Responsive Design**: Optimized for all devices (mobile, tablet, desktop)\n- **Interactive UI**: Smooth animations and micro-interactions using Framer Motion\n\n### Home Page\n- **Hero Section**: Beautiful background with room images and call-to-action\n- **Statistics Section**: Key metrics and achievements\n- **Features Showcase**: Why choose ComfortPG with interactive cards\n- **Featured Rooms**: Highlighted accommodations with quick access\n- **Testimonials**: Customer reviews and ratings\n- **Newsletter Signup**: Email subscription functionality\n\n### Room Management\n- **Advanced Search**: Real-time search with filters\n- **Category Filtering**: Single, Double, Shared, Deluxe, AC, Non-AC rooms\n- **Price Range Filter**: Adjustable price filtering\n- **Room Cards**: Interactive cards with hover effects\n- **Detailed Room Pages**: \n  - Image gallery with navigation\n  - Full room descriptions\n  - Amenities list with icons\n  - Booking and cart functionality\n  - Contact information\n\n### Additional Pages\n- **About Page**: Company story, team, values, and achievements\n- **Contact Page**: Contact form, location map, and business hours\n- **Privacy Policy**: Comprehensive privacy information\n- **Terms \u0026 Conditions**: Legal terms and conditions\n- **Funding Information**: Investment details and funding timeline\n- **Partner Us**: Partnership opportunities and application form\n- **FAQ**: Searchable frequently asked questions\n\n## 🛠️ Tech Stack\n\n### Frontend Framework\n- **React 18.3.1**: Modern React with hooks and functional components\n- **TypeScript 5.5.3**: Type-safe development\n- **Vite 5.4.2**: Fast build tool and development server\n\n### Styling \u0026 UI\n- **Tailwind CSS 3.4.1**: Utility-first CSS framework\n- **Framer Motion 12.23.6**: Animation library for smooth transitions\n- **Lucide React 0.344.0**: Beautiful icon library\n- **PostCSS 8.4.35**: CSS processing\n- **Autoprefixer 10.4.18**: CSS vendor prefixing\n\n### Routing \u0026 Navigation\n- **React Router DOM 7.7.0**: Client-side routing\n\n### Development Tools\n- **ESLint 9.9.1**: Code linting\n- **TypeScript ESLint 8.3.0**: TypeScript-specific linting rules\n- **Vite Plugin React 4.3.1**: React support for Vite\n\n### Build \u0026 Development\n- **Node.js**: Runtime environment\n- **npm**: Package manager\n\n## 📦 Installation\n\n### Prerequisites\n- Node.js (version 16 or higher)\n- npm or yarn package manager\n\n### Step-by-Step Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/codewithdhruba01/ComfortPG_Website.git\n   cd ComfortPG_Website\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Start development server**\n   ```bash\n   npm run dev\n   ```\n\n4. **Open in browser**\n   - Navigate to `http://localhost:5173`\n   - The website will automatically reload when you make changes\n\n### Build for Production\n\n1. **Create production build**\n   ```bash\n   npm run build\n   ```\n\n2. **Preview production build**\n   ```bash\n   npm run preview\n   ```\n\n3. **Deploy**\n   - Upload the `dist` folder to your web server\n   - Or use services like Netlify, Vercel, or GitHub Pages\n\n## 📁 Project Structure\n\n```\nsrc/\n├── components/          # Reusable UI components\n│   ├── Navbar.tsx      # Navigation bar with logo and menu\n│   ├── Footer.tsx      # Footer with links and contact info\n│   └── RoomCard.tsx    # Room listing card component\n├── context/            # React context providers\n│   └── ThemeContext.tsx # Dark/light mode management\n├── data/               # Static data and configurations\n│   └── rooms.ts        # Room data and categories\n├── pages/              # Page components\n│   ├── Home.tsx        # Landing page\n│   ├── Rooms.tsx       # Room listings with search\n│   ├── RoomDetail.tsx  # Individual room details\n│   ├── About.tsx       # About company page\n│   ├── Contact.tsx     # Contact form and info\n│   ├── PrivacyPolicy.tsx # Privacy policy\n│   ├── Terms.tsx       # Terms and conditions\n│   ├── Funding.tsx     # Funding information\n│   ├── Partner.tsx     # Partnership page\n│   └── FAQ.tsx         # Frequently asked questions\n├── types/              # TypeScript type definitions\n│   └── index.ts        # Interface definitions\n├── App.tsx             # Main application component\n├── main.tsx            # Application entry point\n└── index.css           # Global styles and Tailwind imports\n```\n\n\n## 🔧 Configuration\n\n### Tailwind Configuration\nThe project uses a custom Tailwind configuration with:\n- Dark mode support\n- Custom animations\n- Extended color palette\n- Custom spacing values\n- Typography enhancements\n\n### TypeScript Configuration\n- Strict mode enabled\n- Modern ES2020 target\n- React JSX support\n- Path mapping for clean imports\n\n### Vite Configuration\n- React plugin enabled\n- Optimized dependencies\n- Fast refresh support\n- Production optimizations\n\n## Animations \u0026 Interactions\n\n### Framer Motion Features\n- Page transitions\n- Scroll-triggered animations\n- Hover effects\n- Loading states\n- Micro-interactions\n\n### Animation Types\n- **Fade In**: Smooth opacity transitions\n- **Slide Up**: Vertical movement animations\n- **Scale**: Hover and focus effects\n- **Stagger**: Sequential animations for lists\n\n## 🔍 SEO \u0026 Performance\n\n### SEO Optimizations\n- Semantic HTML structure\n- Meta tags and descriptions\n- Proper heading hierarchy\n- Alt text for images\n- Clean URL structure\n\n### Performance Features\n- Code splitting with React.lazy\n- Optimized images\n- Minimal bundle size\n- Fast loading times\n- Efficient re-renders\n\n## 🚀 Deployment\n\n### Vercel Deployment\n1. Connect GitHub repository\n2. Auto-deploy on push\n3. Environment variables configuration\n\n\n## 🤝 Contributing\n\n### Development Workflow\n1. Fork the repository\n2. Create feature branch: `git checkout -b feature/new-feature`\n3. Make changes and test\n4. Commit: `git commit -m \"Add new feature\"`\n5. Push: `git push origin feature/new-feature`\n6. Create Pull Request\n\n### Code Standards\n- Use TypeScript for type safety\n- Follow ESLint rules\n- Write meaningful commit messages\n- Add comments for complex logic\n- Test on multiple devices\n\n## 📄 License\n\nThis project is licensed under the Apache-2.0 License - see the [LICENS](./LICENSE) file for details.\n\n## Links\n\nFor support and questions:\n- **GitHub**: [Follow More](https://github.com/codewithdhruba01)\n- **Website**: [ComfortPG](https://comfort-pg.vercel.app)\n\n## 🙏 Acknowledgments\n\n- **React Team**: For the amazing framework\n- **Tailwind CSS**: For the utility-first CSS framework\n- **Framer Motion**: For smooth animations\n- **Lucide**: For beautiful icons\n- **Pexels**: For high-quality stock images\n\n---\n\n**Made with ❤️ Dhrubaraj Pati**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodewithdhruba01%2Fcomfortpg_website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodewithdhruba01%2Fcomfortpg_website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodewithdhruba01%2Fcomfortpg_website/lists"}