원주 시내버스 정보 서비스 / Wonju City Bus Information Service

A modern, responsive web application for Wonju city buses featuring real-time location tracking and comprehensive schedule information. Built with Next.js, React, TypeScript, and Leaflet.

• Live bus location tracking on an interactive map
• Real-time position updates with smooth animations
• Bus stop information and arrival estimates
• Click on buses for detailed route information
• Automatic data refresh

• Complete bus schedules for all routes
• Weekday and weekend timetables
• Departure time information
• Major bus stop listings

• 📱 Responsive Design: Optimized for mobile, tablet, and desktop
• 🌙 Dark Mode Support: Comfortable viewing in any lighting condition
• ⚡ Performance Optimized: Efficient caching and memory management
• 🎨 Modern UI: Clean interface with smooth animations

• Node.js 20.x or higher
• npm 10.x or higher

# Clone the repository
git clone https://github.com/67D48D5/wBus.git
cd wBus

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your API settings

# Run development server
npm run dev

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

# Build for production
npm run build

# Start production server
npm start

• npm run dev - Start development server with Turbopack
• npm run build - Create production build
• npm start - Start production server
• npm run lint - Run ESLint

• Next.js 15.2 - React framework with App Router
• React 19 - UI library
• TypeScript 5.x - Type-safe development
• Tailwind CSS 4 - Utility-first CSS framework

• Leaflet 1.9 - Interactive maps
• React Leaflet 5 - React bindings for Leaflet
• OpenStreetMap - Map tiles

• lucide-react - Icon library
• next-themes - Dark mode support
• Vercel Analytics - Analytics and insights

wBus/
├── src/
│   ├── app/                    # Next.js app directory
│   │   ├── live/              # Real-time bus tracking page
│   │   ├── schedule/          # Bus schedule/timetable pages
│   │   ├── layout.tsx         # Root layout
│   │   └── page.tsx           # Home page
│   ├── core/                   # Core infrastructure
│   │   ├── api/               # API client utilities
│   │   ├── cache/             # Cache management
│   │   └── constants/         # App-wide constants
│   └── features/               # Feature modules
│       ├── live/              # Live tracking features
│       └── schedule/          # Schedule features
├── public/                     # Static assets
│   ├── data/                  # Static data files (routes, schedules)
│   └── icons/                 # App icons
└── ...config files

Create a .env.local file in the project root:

# Live API Settings
NEXT_PUBLIC_API_URL=https://your-api-gateway.execute-api.ap-northeast-2.amazonaws.com

# Remote Data Configuration (for schedules, routes, etc.)
NEXT_PUBLIC_USE_REMOTE_DATA=false
NEXT_PUBLIC_DATA_URL=

See .env.example for the complete configuration template.

Contributions are welcome! Please feel free to submit a Pull Request.

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

• Bus data provided by 공공데이터포털 (Korea Public Data Portal)
• Map tiles from OpenStreetMap contributors
• Built for the Wonju city community

For issues, questions, or feature requests, please open an issue on GitHub Issues.

Made with ❤️ for Wonju City