README.md

briefsky

briefsky is a free weather frontend to a variety of weather providers, with an interface reminiscent of the late Dark Sky.

briefsky retains all configuration in URL parameters, so you can bookmark multiple locations or weather providers. briefsky is implemented as a client-side app. It doesn't collect user information, show ads, or store cookies.

briefsky currently supports the following weather providers:

• Open-Meteo (default)
• Visual Crossing
• Tomorrow.io
• Pirate Weather
• WeatherFlow Tempest

Some weather providers may require a free API key.

Building

Install packages:

$ npm install

Run local development server:

$ npm run dev

Build production bundle:

$ npm run build

Preview production bundle:

$ npm run preview

Format, lint, and check:

$ npm run format && npm run lint && npm run check

Unsupported Providers

briefsky strives to support free weather providers with open APIs or with free API keys. However, some providers are missing weather data needed by the frontend, or lack sufficient weather data with a free API key. Below is a list of currently unsupported weather providers:

• National Weather Service
  • Missing usable condition icons
  • Missing sunrise/sunset data
• OpenWeather
  • Missing free daily forecast in standard API
  • Missing sufficient free hourly forecast in One Call API (only 48 hours free)
• Meteomatics
  • Does not support CORS
  • Missing apparent temperature, humidity, and dew point in free parameters
• Weatherbit
  • Missing free hourly forecast
• Weatherstack
  • Missing free daily and hourly forecast
• Accuweather
  • Missing sufficient free hourly forecast (only 12 hours free)
• Stormglass.io
  • Does not provide daily forecast

File Structure

• src/ - Sources
  • components/ - Components
    • primitives/ - Primitives
  • providers/ - Weather Providers
  • geocoders/ - Location Geocoders
• public/ - Static assets
• contrib/ - Contributed files
• index.html - Top-level HTML
• package.json - npm package configuration
• package-lock.json - npm package lock
• tsconfig.json - TypeScript (Web) configuration
• tsconfig.node.json - TypeScript (Node) configuration
• vite.config.ts - Vite configuration
• svelte.config.js - Svelte configuration
• postcss.config.cjs - PostCSS configuration
• tailwind.config.cjs - Tailwind configuration
• CHANGELOG.md - Change log
• LICENSE - MIT License
• README.md - This README

License

briefsky is MIT licensed. See the included LICENSE file.