Skip to content

vjjr/LocalLink

Repository files navigation

LocalLink - 3rd PLACE OVERALL IN EUREKA HACKS

A modern application that connects outdoor enthusiasts with each other in their local area, facilitating nature-based activities and fostering community connections through real-time chat and location-based discovery.

Screenshot 2025-04-06 at 11 30 41 AM

Table of Contents

General Information

LocalLink Outdoor is a social platform designed to bring together nature lovers and outdoor enthusiasts in their local communities. The application enables users to discover like-minded individuals nearby, connect through real-time chat, and organize outdoor activities together. With a focus on building local connections through shared interests in nature and outdoor activities, the platform provides a safe and engaging environment for users to expand their outdoor social network.

Features

  • Location-Based Discovery:

    • Find nearby outdoor enthusiasts
    • Discover local outdoor activities and meetups
    • Smart location tracking and management
  • Real-Time Communication:

    • Instant messaging system
    • Chat request management
    • Message archiving
    • Rich media sharing capabilities
  • User Profiles:

    • Customizable user profiles
    • Activity preferences
    • Experience level indicators
    • Profile verification system
  • Modern UI/UX:

    • Nature-inspired design theme
    • Responsive layout for all devices
    • Dark mode support
    • Intuitive navigation
    • Interactive animations
  • Privacy & Security:

    • Secure authentication system
    • Location privacy controls
    • Chat moderation features
    • User blocking capabilities

Tools and Technologies

  • Frontend Framework:

    • React 18 with TypeScript
    • Vite for build tooling
    • React Router for navigation
    • TanStack Query for data fetching
  • UI Components:

    • Shadcn UI components
    • Radix UI primitives
    • Tailwind CSS for styling
    • Custom animations
    • Lucide React icons
  • Backend Services:

    • Supabase for backend functionality
    • Real-time subscriptions
    • Secure data storage
    • Authentication services
  • Location Services:

    • Google Maps integration
    • Geolocation API
    • Location-based matching

Setup

  1. Prerequisites:

    • Node.js 18 or higher
    • npm or yarn package manager
    • Supabase account for backend services
  2. Install Dependencies:

    npm install
    # or
    yarn install
  3. Environment Setup:

    • Create a .env file based on .env.example
    • Configure Supabase credentials
    • Set up Google Maps API key

Usage

  1. Development:

    npm run dev
    # or
    yarn dev

    The application will be available at http://localhost:8080

  2. Production Build:

    npm run build
    # or
    yarn build
  3. Important Notes:

    • Requires modern browser with geolocation support
    • Active internet connection required
    • Location services must be enabled
    • Some features may require user authentication

Additional Notes:

  • Mobile-responsive design
  • Progressive Web App capabilities
  • Regular updates and feature additions
  • Community-driven development

Credits

Created by:

  • Evan Zhou
  • Sathvik Haridasu
  • Vijay Shrivarshan Vijayaraja
  • Vikky Mutchukota

© 2024 LocalLink Outdoor. Connect with nature lovers.

About

A modern application that connects outdoor enthusiasts with each other in their local area, facilitating nature-based activities and fostering community connections through real-time chat and location-based discovery.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages