A premium, high-performance web application designed to help people discover and host local weekend getaways and social adventures. Built with React 18, Vite, TypeScript, and a persistent SQLite backend.
- 🏠 Modern Discovery: Browse through community-hosted events with high-quality imagery and real-time search.
- ✨ Premium UI/UX: Professional design system using Outfit typography, Glassmorphism, and smooth transitions.
- 🔐 Secure Auth: custom-built registration and login system with bcrypt password hashing and JWT sessions.
- 📍 Map Integration: Real-time Google Maps integration for trip locations and meeting points.
- 🛠️ Persistent Storage: Full SQLite implementation for local data persistence (trips, users, attendees).
- 👤 User Profiles: Manage your personal profile, hosted trips, and upcoming weekend adventures.
- 📱 Mobile-First Design: Optimized for everything from small smartphones to large desktop displays.
- Frontend: React 18, Redux Toolkit, RTK Query, Tailwind CSS, React Router v6.
- Backend: Node.js, Express, better-sqlite3, bcrypt for security.
- Auth: Custom Email/Password + JWT.
- Maps: @react-google-maps/api.
- Node.js (v18+)
- npm
# Install dependencies
npm installCreate a .env file in the root directory:
PORT=4000
JWT_SECRET=your_super_secret_key
VITE_GOOGLE_CLIENT_ID=your_google_client_id (Optional for Guest Mode)
VITE_GOOGLE_MAPS_API_KEY=your_google_maps_api_key# Starts both Backend (Port 4000) and Frontend (Port 5173) tasks concurrently
npm run dev:allThe server will automatically initialize a database.sqlite file and seed it with 100 events on the first run.
/src: Frontend React application./server: Node.js/Express server files.db.js: SQLite schema and 100-event seeding logic.index.js: API endpoints and JWT middleware.
/dist: Optimized production build.
© 2026 Weekend Explore. Built for weekend adventurers and community builders.