A modern web application for hostel management, created by and for residents of my own college hostel. This project was started out of a need for efficient room allocation, resident record-keeping, and streamlined communication within our student hostel community.

unik-hostel is tailored specifically to address the administrative and everyday needs of a college hostel environment, based on real-life experience as a resident. It aims to simplify common workflows for hostel staff and residents, improving transparency, convenience, and living experience.

• Dashboard for both hostel administrators and residents
• Room booking, allocation, and management
• Resident registration and profile management
• Announcements and notifications for residents
• Simple interface for communication and requests
• Customizable hostel settings

• Primary Language: TypeScript
• Other Languages: CSS, JavaScript

• Node.js (LTS version recommended)
• npm or yarn

1. Clone the repository:

   git clone https://github.com/newuser1010101/unik-hostel.git
   cd unik-hostel

2. Install dependencies:

   npm install
   # or
   yarn install

3. Run the application:

   npm start
   # or
   yarn start

4. Open http://localhost:3000 in your browser.

Contributions and suggestions are very welcome, especially from fellow hostellers and college students! Feel free to open issues or pull requests to help improve unik-hostel for everyone.

This project is licensed under the MIT License. See the LICENSE file for details.

Built with TypeScript and inspired by real hostel life experience.