Suedtirol Wetter V2
A modern weather application for South Tyrol (Südtirol), Italy. Built with Svelte 5, Tailwind CSS v4, and Open-Meteo API.
Südtirol Wetter App V2
A modern weather application for South Tyrol (Südtirol), Italy. Built with Svelte 5, Tailwind CSS v4, and powered by Open-Meteo API.
✨ Features
- 🌤️ Current Weather - Real-time weather conditions for your location
- 📅 7-Day Forecast - Extended weather predictions
- 🕒 Hourly Forecast - Detailed hour-by-hour breakdown
- 📍 Location Services - Automatic location detection with geolocation API
- ⭐ Favorites - Save your favorite locations
- 🔄 Offline Support - Works offline with service worker caching
- 🌗 Multi-Language - German, Italian, English, and Ladin support
- 🎨 Theme Support - Light, dark, and OLED modes
- 📱 Responsive - Mobile-first design for all devices
- 📲 PWA - Install as a native app on your device
🚀 Quick Start
Prerequisites
- Node.js 18+
- npm or pnpm
Installation
# Clone the repository
git clone https://github.com/openfugjoobot/suedtirol-wetter-v2.git
cd suedtirol-wetter-v2
# Install dependencies
npm install
# Start development server
npm run dev
The app will be available at http://localhost:5173.
📖 Documentation
| Document | Description |
|---|---|
| USER_GUIDE.md | Complete user guide with feature explanations |
| API.md | API documentation for developers |
| DEPLOYMENT.md | Deployment guide and CI/CD setup |
| CONTRIBUTING.md | Contribution guidelines |
| CHANGELOG.md | Version history and changes |
| TECHNICAL.md | Technical architecture documentation |
🛠️ Development
Available Scripts
| Command | Description |
|---|---|
npm run dev |
Start development server with hot reload |
npm run build |
Build for production |
npm run preview |
Preview production build |
npm run check |
Type-check with Svelte and TypeScript |
npm run check:watch |
Watch mode for type checking |
npm run test |
Run unit tests with Vitest |
npm run test:watch |
Watch mode for tests |
npm run test:e2e |
Run E2E tests with Playwright |
npm run lint |
Run ESLint with auto-fix |
Project Structure
src/
├── lib/
│ ├── api/ # API clients (Open-Meteo)
│ ├── components/ # Svelte components
│ │ ├── ui/ # shadcn-svelte primitives
│ │ ├── weather/ # Weather-specific components
│ │ └── location/ # Location components
│ ├── services/ # Business logic services
│ ├── stores/ # Svelte stores
│ ├── types/ # TypeScript definitions
│ ├── hooks/ # Custom Svelte hooks
│ └── i18n/ # Internationalization
├── routes/ # SvelteKit pages
└── static/ # Static assets
🌐 Tech Stack
| Technology | Version | Purpose |
|---|---|---|
| Svelte | 5.x | UI Framework |
| SvelteKit | 2.x | App Framework |
| Tailwind CSS | 4.x | Styling |
| TypeScript | 5.x | Type Safety |
| TanStack Query | 5.x | Data Fetching |
| Vitest | 2.x | Unit Testing |
| Playwright | 1.x | E2E Testing |
| Vite | 6.x | Build Tool |
📡 API
The app uses the free Open-Meteo API:
- ✅ No API key required
- ✅ Fair use policy (reasonable request rates)
- ✅ Data provided by various meteorological agencies
🌍 Supported Languages
- 🇩🇪 German (de) - Default
- 🇮🇹 Italian (it)
- 🇬🇧 English (en)
- 🇱🇻 Ladin (ld)
📱 PWA Installation
Mobile (iOS)
- Open in Safari → Tap Share → Add to Home Screen
Mobile (Android)
- Open in Chrome → Tap Menu → Install App
Desktop
- Chrome/Edge: Click install icon in address bar
- Firefox: Menu → Install
🔧 Building for Production
npm run build
npm run preview
☁️ Deployment
Live URL: 🚀 https://suedtirol-wetter-v2.pages.dev
This app is deployed on Cloudflare Pages with automatic CI/CD via GitHub Actions.
CI/CD Pipeline
- Continuous Integration: Automated testing, linting, and type checking on every push
- Continuous Deployment: Automatic deployment to production on main branch
- Health Monitoring: Automated health checks running 3x daily
- Release Management: Automated GitHub releases with changelog generation
See DEPLOYMENT.md for deployment details and setup instructions.
🤝 Contributing
Contributions are welcome! Please read our contributing guidelines before submitting PRs.
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a Pull Request
📄 License
MIT License - see LICENSE for details.
🙏 Acknowledgments
- Weather data by Open-Meteo
- Icons from Lucide
- UI primitives from shadcn-svelte
Built with ❤️ for South Tyrol
