Skip to content

Net-Gene/guide_to_connect

Repository files navigation

🌍 Guide-to_Connect App

🏨 For Hostel Guests in the Finnish Climate

Interactive onboarding app for enhancing safety, climate readiness, and appliance use.

Designed especially for international visitors staying at Redinor Oy Finnish hostel.


🧭 Key Features

📱 Fully optimized for mobile and multilingual visitors.

🌍 Multi-language onboarding interface.

♠️ Gamified learning path.


🌐 Captive Portal Use Case

The app is hosted locally and presented automatically when a guest connects to Wi-Fi.

App Flow

  1. Guest connects to hostel Wi-Fi
  2. Router redirects to Guide-to_Connect via captive portal
  3. Upon completing the tutorial → Guest completes final test → receives Internet access via:
    • Password to -
    • Or automatic reconnection to the local Wi-Fi

🛠️ Full Feature List

🧭 Overview

Guide-to_Connect is an interactive web application developed to enhance guest safety, comfort, and awareness during their stay at Redinor’s Finnish hostel, especially for international visitors unfamiliar with Nordic climate conditions.

This app offers multilingual text instructions and visual guides, specifically tailored to the Finnish environment.

Topics include, but are not limited to:

  • 🔥 Safe usage of saunas
    • Guidance for first-time or international users unfamiliar with Finnish sauna practices
  • ❄️ How to dress for the cold
    • Weather-specific clothing tips for various seasons and sudden climate changes
  • Proper and safe usage of appliances in nordic conditions
    • E.g. operating heaters safely in cold, moist conditions with proper ventilation.

These onboarding materials help reduce confusion, ensure safer stays, and minimize staff workload by addressing frequent questions in advance.

Desing

  • 🖥️ Landing Page & Start Screen
  • 🧩 Modular Crash Course (multi-step guide)
  • 🕹️ Gamified Learning Path (badges, progress)
  • ✅ Final Comprehension Test
  • 🔓 Wi-Fi Unlock after test completion
  • ♿ Accessibility (WCAG)
  • 📱 Fully Responsive Design

Potential Add-ons

  • QR-code login
  • Guest check-in integration
  • Auto-detect preferred language

🛠️ Tech Stack

Category Tools
UI Framework React, Tailwind CSS
Language TypeScript
Auth & Redirection Captive portal, DNS/DHCP tricks
Hosting Option Local router/web server
Accessibility WCAG Guidelines compliant

🎯 Project Goal

To empower guests through self-service onboarding, while reducing workload and risk for hostel staff.

Not just an info tool — it's a smart access gateway.


Recommended 🤓

Before starting 👇

  1. Create virtual enviroment

    python -m venv .venv 
  2. Activate virtual enviroment

    .venv/Scripts/activate

Getting Started

To get started with the project, follow these steps:

  1. Install Dependencies:

    npm install
  2. Run the Application:

    npm start

✉️ Contact

Please feel free to contact @Net-Gene, if you are intrested 😁.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors