Imported from blackfyre/weatherman (AGENTS.md). Install upstream with npx skills add blackfyre/weatherman. Copyright stays with the author.

Repository Guidelines

Project Structure & Module Organization

This repository is a static single-page weather application.

• src/ contains the source files for the static app.
  • src/index.html contains the page markup.
  • src/app.css contains the app styles.
  • src/app.js contains the app JavaScript.
  • src/manifest.webmanifest, src/service-worker.js, and src/icons/ contain the PWA shell assets.
• public/ contains the Cloudflare Pages publish artefacts. Regenerate it from src/ before deployment.
• Documentation/ contains project notes and ADR topic candidates.
• mise.toml defines local tasks and deployment commands.
• start-codex-tmux.sh starts a tmux workspace for development.

Keep changes surgical. Source changes belong in src/; generated deployment artefacts belong in public/.

Build, Test, and Development Commands

Use mise for routine operations:

• mise run check validates that src/app.js parses.
• mise run sync-public copies the app source files from src/ to public/.
• mise run serve serves the app locally on port 8000.
• mise run deploy runs validation, syncs the publish file, and deploys public/ to Cloudflare Pages.
• mise run configure-production-branch is a separate Cloudflare Pages configuration task. Do not include it in routine deploys.

The app has no package build step. Avoid adding one unless it directly solves a project requirement.

Coding Style & Naming Conventions

Keep the page dependency-free and readable. Use plain HTML, CSS, and JavaScript. Prefer explicit constants for fixed value sets such as provider IDs, crop names, locale codes, work types, and map layers. Keep provider-specific parsing isolated from aggregation and UI rendering.

Use two-space indentation in HTML, CSS, and JavaScript. Use descriptive camelCase names for JavaScript variables and functions. Keep user-facing strings routed through the translation structure.

Testing Guidelines

There is no formal test framework yet. At minimum, run mise run check before deployment. For UI changes, also run mise run serve and manually verify the page in a browser, including Hungarian and English language modes, provider source display, agricultural evaluation, and map embedding.

Commit & Pull Request Guidelines

Use Conventional Commits for commit messages, for example feat: add barley crop rules or docs: document deployment tasks.

Pull requests should describe the user-visible change, list manual checks performed, and include screenshots for visual changes.

Documentation Maintenance

Keep documentation current when code changes. If a change affects structure, commands, deployment, testing, architecture decisions, or user-visible behaviour, update the relevant repository documentation in the same change.

Security & Configuration Tips

Cloudflare credentials are sensitive. Do not commit real API tokens. Prefer environment variables or local secret tooling for CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_API_TOKEN.