Alby96/Europa
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: Alby96/Europa:7a45880059ab2753c157e220a3861a91cec7a1d8
Branches Tags
Alby96/Europa:main
...
compare: Alby96/Europa:a686f7625e09fcce468ed0045591b9758af749a7
Branches Tags
Alby96/Europa:main
18 Commits
7a45880059 ... a686f7625e
Author SHA1 Message Date
Alby96andClaude Opus 5 a686f7625e Mark the place the map is pointed at, and make following work 
Choosing a town moved the camera and then left the reader to work out which of
the settlements now on screen was the one they asked for. A town has no precise
position, so the map now marks its centre: a white disc under a coloured dot,
drawn as a style layer so the native renderer keeps it pinned through every pan
and zoom. The radar frames are inserted below it, because a band of rain must
not paint over the one thing that says which town this is.

A searched municipality becomes a PointTarget rather than being thrown away as
"the whole region". It is marked, the recentre button returns to it, and the
chip names it - but it is never persisted, so looking something up no longer
costs the user the place their app opens on. That was a real defect: searching
went through select(FreeTarget), which wrote null over the stored preference.

Following the device was broken outright. MapLibre reports a camera animation
the app started exactly as it reports the user grabbing the map, so engaging
follow and then animating to the position cancelled the follow it had just
started; the resulting FreeTarget then re-framed the whole region. Follow now
moves the camera first and switches tracking on second, and FreeTarget no longer
moves the camera as a reaction to the state changing - framing the region is an
action, so panning away while following keeps the view the user panned to.

Verified on the emulator with a fix in Turin: a searched town is marked and
saveable, the app reopens on it with the marker in place, following centres on
the blue dot, and panning stops the chase without yanking the map away.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 23:17:21 +02:00
Alby96andClaude Opus 5 f434a68155 Replace the default Flutter icon with a stylised cloud 
The app shipped the Flutter template's blue F, which said nothing about what it
does and did not match the interface. The launcher icon is now a white cloud on
the same seed blue the app themes itself with, so the two read as one product.

The icon is drawn rather than hand-edited: tool/generate_icon.py renders it from
signed distance fields — a union of three circles and a rounded box — using only
the standard library, so regenerating it needs no image toolchain. The shape's
framing is derived from its own bounding box, which is what keeps it centred;
maintaining the bounds separately from the shape had it drifting off-centre.

Adds the adaptive icon and the Android 13 monochrome layer, which were missing
entirely. The generator frames the cloud against the 72dp the launcher mask
always keeps and adaptive_icon_foreground_inset is 0, so the layer is not shrunk
twice and the icon reads at the same size as its neighbours on a home screen.

Verified on the emulator: the cloud appears in the app drawer and holds its shape
down to 48px. docs/architecture.md records how to regenerate it, including the
flutter_launcher_icons 0.14.4 bug that writes a string into a boolean Xcode
setting and needs reverting by hand afterwards.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 22:44:33 +02:00
Alby96andClaude Opus 5 aa91b457ed Give the map the whole screen and move the credits into settings 
Drops the app bar, moves settings onto the map with the other controls, and
takes the attribution bar off the main screen.

The app bar held only the app name — which the launcher already shows — and one
action, so removing it hands its height to the map rather than leaving an empty
strip. The settings button joins search and recentre in the column over the
map, where the rest of the controls that act on the map already live.

The attribution needed checking before it could move, because it is a licence
obligation rather than a layout choice. The OSMF guidelines settle it: for a
browsable map the credit does not have to be permanently visible, provided
"the user must still be able to find the licence information if they look for
it, for example from an '(i)' button in the corner of the map or an 'About'
option in a menu". Map to settings to "Fonti e licenze" is exactly that, and
MapLibre's own (i) control now sits in the map's top-right corner as a second
route — it had been landing underneath the new button column.

Two things had to follow the bar rather than disappear with it. The radar
manifest carries its own credit for the frames on screen, set by whoever
published them and absent from the region config, so the Sources screen now
shows it alongside the configured attributions. And the settings entry that
leads there carries a subtitle saying what it holds, because "Fonti e licenze"
alone does not tell a reader that this is where the licence information went.

settings_screen_test asserts that entry exists and opens the screen. Removing
it would be a licence breach, so it should fail the build rather than ship
quietly.

Verified on the emulator: no title bar, the map runs to the top with the demo
notice above it, the three controls stack bottom-right without colliding with
the (i), and settings shows the sources entry with its subtitle.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 22:21:50 +02:00
Alby96andClaude Opus 5 b4b8d089e6 Add municipality and coordinate search, and a map target selector 
Puts the controls that change what the map is looking at over the map itself,
where they act, and gives them something to search.

Search is one field, not two. A string either parses as coordinates or it does
not, and the answer is obvious from the text, so making the user declare up
front which kind of thing they are looking for would be asking them to do the
program's job. Coordinates accept decimal and degrees-minutes-seconds, comma or
space separated, with hemisphere letters — including the Italian O for ovest,
because someone reading an Italian map will type it and silently reading it as
east would put them the wrong side of Greenwich.

The 1180 Piedmont municipalities are bundled rather than geocoded online. The
app is region-scoped, so a list of one region's towns is small enough to ship
(100 KB) and beats a geocoder on every axis that matters: instant, offline, no
API key, no rate limit, and it cannot return a result somewhere the app has no
radar for. Matching folds accents, so "aglie" finds "Agliè", and prefix matches
outrank substring ones — typing "tor" should surface Torino, not the first
alphabetical name that happens to contain those letters.

tool/generate_places.py derives the list from Istat boundary shapefiles
(CC BY 4.0). Two properties of that file cost time and are now written down:
the geometry is UTM 32N rather than degrees, and the DBF is UTF-8 despite one
bilingual Friulian record that makes strict cp1252 fail. A terminal renders
utf-8 and latin-1 output identically, so the encoding cannot be settled by
looking at printed text — it took dumping codepoints. A guard in the generator
and a test against the shipped asset both check for mojibake now, and the guard
caught a real mistake the moment it was written.

The target selector switches between following the device, a saved place, and
the whole region, and the selection doubles as what the app reopens on: "the
place I marked" and "what I see when I open the app" are one idea to the person
using it. Dragging the map while it is following stops the camera chasing them
but leaves that preference alone, because looking somewhere else now is not the
same as changing their mind about next launch.

The position marker and the following are MapLibre's own, driven by
onCameraTrackingDismissed, so there is no second location stream to keep in step
with the map.

A test asserts that all 1180 municipalities fall inside the region bounds, which
is what actually validates the UTM-to-degrees conversion end to end.

Verified on the emulator: the dropdown lists follow, region and both saved
places; "aglie" finds Agliè; "44.3841 7.5426" offers the coordinate jump and
lands on Cuneo at town-reading zoom; selecting follow moves the map to the
device position with the blue dot on it and changes the recentre button to
match.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 21:47:20 +02:00
Alby96andClaude Opus 5 06ab816ebe Add saved places and optional device location 
A saved place is a named point the user keeps: it frames the map now, and once
the worker publishes station data it is what the nearest-station readings and,
later, the rain notifications will hang off. Free points rather than stations,
because people think in terms of home and work, not in terms of which weather
station happens to represent them.

Everything stays on the device. Places live in SharedPreferences under a
versioned key, and there is no account to attach them to and no server that
would accept them. That is what keeps the Data safety declaration able to say
no location is collected, and it must survive the notification work: the device
will subscribe to the topic for the cell containing a place, so the link
between a person and a place never leaves their phone.

Location is coarse only, and that took enforcing. geolocator declares
ACCESS_FINE_LOCATION in its own manifest and the merger pulls it in, so the
system dialog offered "Precise" despite the app asking for nothing of the sort;
the manifest now removes it with tools:node="remove", and the dialog reads
"approximate location" with no choice offered. Requests also go through the
platform LocationManager rather than the Play Services fused provider, which
prompts about Location Accuracy and, when declined, returns no fix at all —
an absurd outcome for an app that only ever wanted an approximate one, and one
that also tied location to Play Services being present.

The prominent disclosure comes before the system dialog, as Play requires, and
is repeated in Settings so someone who already answered can still read what the
permission is for. Declining leaves the app fully usable.

Two more defects found by running it and by a test:

- MapLibreMap leaves cameraPosition null unless trackCameraPosition is set, so
  "save the map centre" silently saved the region default rather than what the
  user was looking at.
- Place ids came straight from the microsecond clock, so two places saved in
  the same microsecond shared an id and rename, remove and the duplicate-name
  check all acted on the wrong one. A test caught it on a fast machine.

Saving refuses points outside the region rather than accepting them: a place in
Rome would look like it worked and then show nothing forever.

Also corrects CLAUDE.md, which still said ARPA states no licence, and records
the ARPA realtime API there with the property that governs how it may be used —
it lags about 4.5 hours, so it is an observation archive and must never sit
next to 5-minute radar looking current.

Verified: analyze clean, 158 tests passing, and on the emulator the disclosure
precedes the system dialog, the dialog asks only for approximate location, a
place survives restart and reinstall, and tapping one moves the map onto it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 19:39:03 +02:00
Alby96andClaude Opus 5 e14308bbb6 Survey the ARPA REST APIs and correct the licence position 
Scanned the two public ARPA Piemonte APIs and recorded what they actually
contain, so this question does not get re-litigated from the marketing pages
later. Neither needs a key, a token or a registration.

This corrects something I got wrong. The docs said ARPA states no licence for
its data, based on the open-data page saying only "gratuiti". The site's legal
notice does state one — CC BY 4.0, commercial use explicitly permitted, credit
"Fonte: Arpa Piemonte - www.arpa.piemonte.it" — and both APIs link that notice
from their OpenAPI description, so anything they serve is covered. Only the
radar volumes remain ambiguous, because their own page does not repeat the
licence and the access link is still issued by email; both questions belong in
the same message to ARPA.

The survey's operative findings:

- api_realtime carries 374 stations with coordinates, of which 286 have a rain
  gauge, spanning 74 m to 2820 m of elevation.
- Its observations lag by about 4.5 hours on an hourly cadence, measured
  uniformly across every station sampled. That is the property that decides how
  it can be used: it is an observation archive with a publishing delay, not a
  real-time feed, and it must never sit next to 5-minute radar looking current.
- Only 4 of 143 hydrometer stations publish guard and danger thresholds, and 5
  publish a river name. A river-level warning built on this would be empty for
  97% of stations, so that idea is recorded as rejected rather than pending.
- Meteoweb is a 3.27-million-record historical archive plus a seismic
  catalogue: a research dataset, not app content.

One thing is worth adopting: rain-gauge accumulations as ground truth for the
radar. Radar infers rainfall from reflectivity aloft, gauges measure what
reached the ground, and the network is densest exactly where Alpine terrain
blocks the beam. It belongs behind the worker, clearly timestamped, once the
worker exists.

Also notes that the credit ARPA asks for is the full "Fonte: Arpa Piemonte -
www.arpa.piemonte.it", not the bare name currently in the region config, to be
adopted the moment any ARPA-sourced data is displayed.

No code changes: nothing is integrated yet.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 16:33:55 +02:00
Alby96andClaude Opus 5 f3a0e3794a Narrow scope to radar, and put the app on a real OpenStreetMap base map 
Drops forecasts, lightning, the home-screen widget and advertising. What
remains is radar on a map, the official ARPA alert bulletin, and rain
notifications.

The base map is now OpenFreeMap's Positron style: real OpenStreetMap vector
tiles with no API key, no registration, no request limits and commercial use
permitted. Every other free tier — MapTiler, Stadia, Jawg, Thunderforest —
needs a key, which is a secret to manage, a quota to outgrow and a signup to
complete before anyone can build the project, and the map is the one thing the
app cannot work without. Positron rather than Liberty or Bright because the
radar overlay has to be the loudest thing on screen, and a desaturated grey
base is built to sit under data.

Its style JSON carries no `attribution` field, so MapLibre displays no credits
by itself. The app renders them from the region config instead: the two
mandatory credits, OpenStreetMap and OpenMapTiles, go in the always-visible
bar, and OpenFreeMap's own credit — optional by their terms — is listed on the
Sources screen with the rest. The bundled offline style is still reachable with
MAP_STYLE_URL=offline, and still claims no base map attribution, because
crediting OpenStreetMap while showing it would be a false claim.

Radar-DPC stays the source. ARPA Piemonte's own radar remains a disabled stub
for two reasons that belong to the project owner, not to the code: the
real-time access link is only issued by email, and the open-data page states
the data is "gratuiti" and nothing else. Free of charge is not a licence, and
rendering those volumes into frames served from a CDN is redistribution. Both
questions go in the same email. An earlier draft of the docs recorded ARPA
radar as CC BY 4.0; the source page does not support that, so the claim is
removed rather than carried forward.

The documentation is updated throughout rather than annotated: CLAUDE.md gains
an explicit scope boundary, data-sources drops MET Norway and ISTAT and gains
the base map, licenses records that free of charge is not a licence, privacy
loses the whole advertising section, and the roadmap is renumbered so the
backend worker is next — until it exists, DpcRadarSource has nothing to read.

licenses.md keeps Open-Meteo and Blitzortung listed as excluded even though the
features that would have used them are gone: both are non-commercial-only, ads
are a plausible future, and neither should be adopted on the grounds that there
are none today.

Verified: analyze clean, 130 tests passing, and on the emulator the radar
overlay sits correctly over Piedmont on real OSM tiles with Turin, Milan and
Genoa labelled, the age reads "Aggiornato 4 minuti fa", and the Sources screen
lists all five credits with their licences.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 16:10:29 +02:00
Alby96andClaude Opus 5 91f9ac0fbf Animate the radar timeline with a double-buffered overlay 
Completes milestone 3: frames render over the map, play as a loop, and can be
scrubbed, with the legend drawn from the manifest rather than a constant that
could drift from what the worker actually rendered.

The overlay alternates two MapLibre image sources. Updating one source in place
flickers, because the layer briefly shows a half-written texture; adding every
frame as its own layer avoids that but pins them all in GPU memory, and twenty
512x512 RGBA frames is about 80 MB. Two buffers cost the same whether the
timeline holds six frames or sixty. Platform-channel work is serialised because
`show` is called faster than the round trip completes during playback, and
overlapping updates would swap visibility out of order and strobe.

Prefetching loads a window around the playhead, nearest first and forward
before backward, since playback moves forward and that frame is needed
soonest. `FrameCache` is byte-budgeted rather than entry-counted because frame
size tracks how much precipitation is on screen, and it evicts by distance from
the playhead: plain LRU would keep frames the prefetcher touched a moment ago
even after the playhead moved to the far end of the timeline.

Also adds DpcRadarSource, which reads published frames from our CDN and never
from the DPC API. Without it, the `dpc` adapter would have had to fall back to
mock, putting demo frames on screen under the label of live data — exactly the
confusion the adapter split exists to prevent. It now fails naming the missing
setting instead.

Running it on the emulator caught three things the tests had not:

- The notifier wrote to `state` from inside `build()`, which Riverpod rejects
  as an uninitialised provider. That broke startup, not just tests.
- Eight-month-old demo frames rendered as "Aggiornato 342535 minuti fa". The
  age formatter now steps up to hours and days.
- Demo mode sat permanently behind a stale-data warning and so never showed the
  working state it exists to demonstrate. MockRadarSource now shifts the
  bundled timestamps onto the present, leaving images, order and spacing
  untouched, so the timeline behaves exactly as it would on live data.

Corrects docs/stack-decisions.md, which described a disk cache that was not
built: mock frames already live in the asset bundle, so a disk layer belongs
with the network adapter where it would save a real request.

Verified: analyze clean, 129 tests passing, and on the emulator the loop
advances, wraps, and reports "Aggiornato ora".

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 12:57:16 +02:00
Alby96andClaude Opus 5 8ff8a903b8 Document the VS Code debug configurations in the README 
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 12:37:09 +02:00
Alby96andClaude Opus 5 75c4c55f81 Add VS Code run-and-debug configurations for the Android emulator 
F5 now builds, installs and attaches the debugger on the emulator, with the
emulator booted automatically first, so there is no manual setup step between
opening the project and stepping through code.

tool/start_emulator.ps1 backs the preLaunchTask and is idempotent: it returns in
about three seconds when a device is already attached, so re-launching the
debugger cannot stack emulator instances. It fails with a useful message when
the AVD is missing rather than hanging until a timeout.

Five configurations rather than one, because they answer different questions.
The profile-mode entry matters most for what comes next: debug builds run the
Dart VM unoptimised, so the radar animation always looks worse than it is, and
milestone 3's acceptance criterion is about whether it runs smoothly. The
Windows entry trades the map away for a launch that takes seconds, which is
worth it for pure UI work.

Verified on this machine: the script cold-boots the AVD and waits for
sys.boot_completed, and a second run exits immediately.

Also removes the broken pixel_7_-_api_35 AVD, which could not boot because its
system image was never installed. That returned 4.8 GB, taking free disk from
3.5 GB to 10.7 GB.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 12:36:36 +02:00
Alby96andClaude Opus 5 7c0a1bd180 Disable emulator quickboot snapshots 
The AVD's quickboot snapshot had grown to 2.6 GB, which took this machine down
to 1.4 GB free. Saving a minute of boot time is not worth that here, so cold
boot is now the default and the snapshot directory is gone.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 12:28:03 +02:00
Alby96andClaude Opus 5 47049b39e7 Fit the map to the region and keep attribution clear of the gesture bar 
Running the app on an emulator for the first time showed two problems that the
unit tests could not have caught, because both are about what the pixels
actually do.

The configured initial zoom of 7.2 puts the viewport entirely inside the
region on a 411dp-wide screen, so the map rendered as a flat expanse of fill
colour with no outline, border or reference point anywhere in view — it read as
a failure to load. A single zoom number cannot frame a region on both a phone
and a tablet, so the camera now fits the region bounds once the map is ready,
which is correct at any screen size. The configured zoom stays as the starting
position before the fit.

The attribution bar sat behind the system gesture pill. A credit that is
covered by the navigation bar is a credit that is not being displayed, which is
the thing ODbL and CC BY-SA actually require, so it now sits inside a SafeArea.

Also records how to run and screenshot the app on the `nuvolari` AVD, and notes
the pre-existing broken `pixel_7_-_api_35` AVD that is holding 4.8 GB.

Verified on the emulator: the region outline is framed with margin, the
attribution bar is clear of the pill, and the Sources screen shows the
disclaimer, all four credits with their licences, the "no licence stated" line
for ARPA and the share-alike note.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 12:25:55 +02:00
Alby96andClaude Opus 5 71557a02d7 Add the radar data layer with the offline mock adapter 
Introduces the RadarSource seam and the manifest it speaks, plus the demo
frames that make the app runnable with no network and no credentials.

MockRadarSource is a real adapter rather than test scaffolding, and that is
what makes the rest of milestone 3 testable: the timeline, prefetching, cache
eviction and every degraded path can be exercised offline because the demo
frames parse the same manifest document the Python worker will publish. Its
assets come from tool/generate_mock_frames.py — committed so the app runs from
a clone, generated by a script so they can be regenerated instead of
hand-edited. Twenty-four 512x512 frames total 108 KB, and the generator is
pure standard library so nobody needs Pillow to build the app.

The manifest parser rejects three things that would otherwise fail silently and
look plausible:

- A CRS other than EPSG:3857. The map overlays each PNG on a lat/lng quad,
  which only lines up if the image is already in Web Mercator; anything else
  renders visibly skewed with no error to explain why.
- A missing attribution. The frames are a derived product of CC BY-SA data, so
  the credit has to travel with them rather than be remembered at render time.
- Legend stops that do not ascend, which would silently mislabel intensities.

The legend travels in the manifest rather than living as a constant here,
because the worker chose those colours when it rendered the PNGs and a local
copy could drift. RadarLegend.colorFor returns null below the lowest stop:
"no precipitation" has to be transparent, not the first colour of the ramp, or
a dry region renders as drizzle everywhere.

Every failure reaches the caller as a single RadarUnavailableException
regardless of cause, because the app's response is the same in all of them —
hold the last good frame and say how old it is — and branching on cause would
only invite divergence.

ArpaRadarSource is a stub whose every method throws. It is named by the region
config as unavailable and must fail loudly: quietly serving something else
would misreport where the data came from.

Verified: analyze clean, 95 tests passing, including a check that every frame
the manifest lists exists and is a real PNG, and that its bbox matches the
region config.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 12:04:22 +02:00
Alby96andClaude Opus 5 4142b67a8d Record why the Android NDK is required 
Hiding the NDK and rebuilding showed the build fails without it, and the reason
is not obvious from this repository: maplibre_gl pins ndkVersion 28.2.13676358
in its own build file, and AGP needs every module to agree on one NDK. The app
has no native sources and no Dart FFI, so the declaration reads like dead
configuration and invites exactly the deletion that was just tried.

Costs about 2 GB of Android SDK. Notes the full toolchain disk budget in the
README as well, since a warm Gradle cache plus build output pushes the total to
roughly 14 GB.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 11:44:23 +02:00
Alby96andClaude Opus 5 d84095b5a8 Add the region map, permanent attribution and the Sources screen 
Puts a MapLibre map on screen framed on the region, with the credit
obligations that come with showing third-party data satisfied structurally
rather than by remembering to add a label.

The base map style comes from MAP_STYLE_URL, and with no key configured the
app generates a fallback style from the region's own bounding box: a flat
background and the extent outline, no network sources at all. That keeps a
fresh clone runnable offline without pulling in a boundary dataset that would
carry its own licence, and it deliberately looks like a placeholder so it is
not mistaken for a finished map.

Attribution is driven by what is actually rendered. The bar lists the credits
for the active sources only, because crediting OpenStreetMap while showing the
fallback style would be a false attribution, and it says plainly when no base
map is configured. It sits below the map rather than floating over it so no
map control or gesture overlay can occlude a credit that the ODbL and CC BY-SA
terms require to be visible.

The Sources screen leads with the independence disclaimer, before the sources
it qualifies, so a reader who stops after the first screenful has still seen
it. Sources with no stated licence — ARPA publishes none for the alert
bulletin — say so explicitly rather than being shown bare or given an invented
one. A separate note explains that the rendered radar frames inherit CC BY-SA
from the DPC source data.

Also declares the INTERNET permission in the main manifest: Flutter injects it
into the debug and profile manifests only, so a release build would otherwise
fail every request on device.

Verified: analyze clean, 66 tests passing, appbundle builds with the native
MapLibre plugin. Not verified visually — this machine has no Android device or
emulator image, so nobody has watched the map render.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 11:35:14 +02:00
Alby96andClaude Opus 5 85b2c99949 Scaffold the Flutter app with Italian l10n and region configuration 
Creates the app skeleton and the seam everything else in the project hangs
off: region-specific data lives in an asset file, not in code, so adding a
region later is a new JSON file rather than a refactor.

Notable choices:

- applicationId and namespace are it.nuvolari.app rather than the doubled
  it.nuvolari.nuvolari that `flutter create` produces, with the Kotlin package
  and the iOS bundle identifiers moved to match.
- SDK levels are pinned instead of inherited from `flutter.*`. Google Play
  requires API 36, and that is a release blocker rather than something to let a
  Flutter upgrade change silently. minSdk 24 is the highest floor the planned
  dependencies impose.
- Riverpod and Dio-free for now, no code generation: see docs/stack-decisions.md.
- Italian is the l10n source language, so app_it.arb is the template rather
  than a translation of an English original.

The region parser rejects rather than repairs. An inverted bounding box, a map
centre outside its own bounds, an unknown adapter name, a duplicate zone code
or an empty attribution list all throw with the offending field named. Each of
those would otherwise fail silently and visibly wrong: a swapped latitude and
longitude renders the radar in the wrong place, an unknown adapter falling back
to mock would show demo frames where live data was expected, and a missing
attribution is a licence violation rather than a cosmetic gap.

Tests run against the asset that actually ships and against a captured copy of
the live ARPA CAP feed, so the eleven zone codes in the config are checked
against the eleven the feed really emits rather than against a list retyped
from documentation.

Verified: dart format clean, flutter analyze 0 issues, 50 tests passing,
flutter build appbundle --debug produces an AAB with applicationId
it.nuvolari.app, minSdk 24, targetSdk 36.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 11:24:26 +02:00
Alby96andClaude Opus 5 3fcbb9f1c4 Add monorepo scaffolding and project documentation 
Sets up the Nuvolari monorepo layout (app/, backend/, docs/, tool/) with the
groundwork that does not depend on the Flutter toolchain: gitignore covering
Flutter, Python and every secret file shape; env.example.json as the template
for --dart-define-from-file; a verification script that skips stages whose
target does not exist yet so it is runnable from day one; and a CI workflow in
GitHub Actions syntax so it runs unchanged on Gitea or GitHub.

The documentation records facts verified against the live services rather than
restated from the brief. Two of them change the design:

- DPC VMI rasters are 1200x1400 Float32 on a 1 km grid in a custom projection
  centred on Italy, not EPSG:4326 or EPSG:3857, and their GeoKeys are
  internally inconsistent. Reprojection is mandatory and the source CRS must be
  read from each file rather than hardcoded.
- The ARPA CAP feed carries six level values, not four: BIANCO for the
  avalanche scale out of season and "-" for no data. Collapsing either into
  VERDE would report "no alert" where the bulletin reports "not assessed".

Also documents why the frames we publish inherit CC BY-SA from the DPC source,
and why rain notifications subscribe to cell topics from the device so no user
location ever reaches a server.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 10:50:40 +02:00
Alby96andClaude Opus 5 3b0fce2516 Drop Xamarin skeleton and add project guidelines 
The Nuvolari app is being rebuilt as a Flutter project targeting Android
first and iOS later on a single codebase, so the original Xamarin.Android
skeleton no longer applies. Its files were already removed from the working
tree; this records the removal.

Adds CLAUDE.md with the golden rules that constrain the rewrite: English
code and commit messages with Italian UI via ARB, no secrets in the repo,
AdMob test IDs only, no direct polling of ARPA/DPC from the app, and no
server-side precise user locations.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-10 10:36:57 +02:00
208 changed files with 14544 additions and 227 deletions
Expand all files Collapse all files
Nuvolari/.gitattributes
+23
View File
@@ -0,0 +1,23 @@
# Normalise text to LF in the repository; Git checks out native line endings.
* text=auto
# Shell scripts must keep LF even on Windows checkouts or they fail to run.
*.sh text eol=lf
gradlew text eol=lf
# Xcode project files are line-ending sensitive.
*.pbxproj text eol=lf
# Binary assets — never diffed, never normalised.
*.png binary
*.jpg binary
*.jpeg binary
*.webp binary
*.ico binary
*.ttf binary
*.otf binary
*.woff binary
*.woff2 binary
*.tif binary
*.jks binary
*.keystore binary
Nuvolari/.gitea/workflows/ci.yml
+78
View File
@@ -0,0 +1,78 @@
# Gitea Actions workflow, written in GitHub Actions syntax so it runs unchanged on
# either host. If the Gitea instance has no runner configured this file is inert and
# tool/verify.ps1 is the verification that must pass locally.
name: CI
on:
push:
branches: [main]
paths: ['Nuvolari/**']
pull_request:
paths: ['Nuvolari/**']
defaults:
run:
working-directory: Nuvolari
jobs:
app:
name: Flutter app
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: subosito/flutter-action@v2
with:
flutter-version: '3.47.3'
channel: stable
cache: true
- name: Install dependencies
working-directory: Nuvolari/app
run: flutter pub get
- name: Check formatting
working-directory: Nuvolari/app
run: dart format --set-exit-if-changed .
- name: Analyze
working-directory: Nuvolari/app
run: flutter analyze
- name: Test
working-directory: Nuvolari/app
run: flutter test
backend:
name: Python worker
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: '3.13'
- name: Skip when the worker does not exist yet
id: guard
run: |
if [ -f backend/pyproject.toml ]; then
echo "exists=true" >> "$GITHUB_OUTPUT"
else
echo "exists=false" >> "$GITHUB_OUTPUT"
fi
- name: Install dependencies
if: steps.guard.outputs.exists == 'true'
working-directory: Nuvolari/backend
run: pip install -e ".[dev]"
- name: Lint
if: steps.guard.outputs.exists == 'true'
working-directory: Nuvolari/backend
run: ruff check .
- name: Test
if: steps.guard.outputs.exists == 'true'
working-directory: Nuvolari/backend
run: pytest -q
Nuvolari/.gitignore
+67
View File
@@ -0,0 +1,67 @@
# ---------------------------------------------------------------------------
# Nuvolari — Flutter app + Python worker
# The repository root (Europa/.gitignore) only covers Visual Studio artifacts.
# ---------------------------------------------------------------------------
# Secrets — never commit. Use env.example.json as the template and pass the
# real file with `flutter run --dart-define-from-file=env.json`.
env.json
.env
.env.*
!.env.example
key.properties
*.jks
*.keystore
google-services.json
GoogleService-Info.plist
service-account*.json
# Dart / Flutter
.dart_tool/
.flutter-plugins
.flutter-plugins-dependencies
.packages
.pub-cache/
.pub/
build/
**/doc/api/
*.iml
migrate_working_dir/
coverage/
# Android
app/android/local.properties
app/android/.gradle/
app/android/captures/
app/android/key.properties
*.apk
*.aab
# iOS / macOS
app/ios/Pods/
app/ios/.symlinks/
app/ios/Flutter/Flutter.framework
app/ios/Flutter/Flutter.podspec
app/ios/Flutter/Generated.xcconfig
app/ios/Flutter/flutter_export_environment.sh
**/.DS_Store
# Python worker
.venv/
venv/
__pycache__/
*.py[cod]
.pytest_cache/
.ruff_cache/
.mypy_cache/
*.egg-info/
# Worker output — generated radar frames and manifests, never versioned
backend/out/
backend/.cache/
# Editors
.idea/
# Downloaded source archives for tool/ generators.
tool/.cache/
Nuvolari/.vscode/extensions.json
Vendored
+7
View File
@@ -0,0 +1,7 @@
{
"recommendations": [
"dart-code.flutter",
"dart-code.dart-code",
"ms-vscode.powershell"
]
}
Nuvolari/.vscode/launch.json
Vendored
+75
View File
@@ -0,0 +1,75 @@
{
// Debug configurations for the Run and Debug panel (F5).
//
// Open the "Nuvolari" folder as the VS Code workspace root — these paths are
// relative to it, not to the repository root.
//
// Every configuration boots the Android emulator first via a preLaunchTask,
// so F5 works from a cold machine with no manual step. The task returns
// immediately if a device is already attached.
"version": "0.2.0",
"configurations": [
{
// The everyday one: demo mode, no env.json needed, hot reload on save.
"name": "Nuvolari — debug (emulatore)",
"type": "dart",
"request": "launch",
"program": "${workspaceFolder}/app/lib/main.dart",
"cwd": "${workspaceFolder}/app",
"deviceId": "emulator-5554",
"flutterMode": "debug",
"preLaunchTask": "Avvia emulatore Android"
},
{
// Debug builds run the Dart VM unoptimised, so animation always looks
// worse than it is. Judge the radar timeline here, never in debug.
"name": "Nuvolari — profile (misura le prestazioni)",
"type": "dart",
"request": "launch",
"program": "${workspaceFolder}/app/lib/main.dart",
"cwd": "${workspaceFolder}/app",
"deviceId": "emulator-5554",
"flutterMode": "profile",
"preLaunchTask": "Avvia emulatore Android"
},
{
// Same as the first, but pointed at a live radar manifest. Requires
// env.json, which is git-ignored — copy env.example.json and fill it in.
"name": "Nuvolari — debug con env.json",
"type": "dart",
"request": "launch",
"program": "${workspaceFolder}/app/lib/main.dart",
"cwd": "${workspaceFolder}/app",
"deviceId": "emulator-5554",
"flutterMode": "debug",
"toolArgs": ["--dart-define-from-file=${workspaceFolder}/env.json"],
"preLaunchTask": "Avvia emulatore Android"
},
{
// Runs on the workstation instead of a device: no emulator, no Android
// build, seconds to start. Good for UI work; the native map will not
// render here, so it is useless for anything map-related.
"name": "Nuvolari — debug su Windows (senza mappa)",
"type": "dart",
"request": "launch",
"program": "${workspaceFolder}/app/lib/main.dart",
"cwd": "${workspaceFolder}/app",
"deviceId": "windows",
"flutterMode": "debug"
},
{
"name": "Test — tutti",
"type": "dart",
"request": "launch",
"program": "${workspaceFolder}/app/test",
"cwd": "${workspaceFolder}/app"
},
{
"name": "Test — file corrente",
"type": "dart",
"request": "launch",
"program": "${file}",
"cwd": "${workspaceFolder}/app"
}
]
}
Nuvolari/.vscode/settings.json
Vendored
+31
View File
@@ -0,0 +1,31 @@
{
// Forward slashes on purpose: VS Code accepts them on Windows and they avoid
// the JSON backslash-escaping trap.
"dart.flutterSdkPath": "C:/src/flutter",
// Format and fix imports on save; `dart format` is enforced by tool/verify.ps1
// anyway, so catching it here avoids a failed verification later.
"[dart]": {
"editor.formatOnSave": true,
"editor.rulers": [80],
"editor.selectionHighlight": false,
"editor.tabCompletion": "onlySnippets",
"editor.wordBasedSuggestions": "off"
},
// Generated from lib/l10n/*.arb during pub get, and git-ignored.
"dart.analysisExcludedFolders": ["app/build", "app/.dart_tool"],
"files.exclude": {
"**/.dart_tool": true,
"**/build": true,
"**/.gradle": true
},
// Radar frames are binary and numerous; keeping them out of search results
// makes finding code faster.
"search.exclude": {
"**/app/assets/mock/frames": true,
"**/app/lib/l10n/app_localizations*.dart": true
}
}
Nuvolari/.vscode/tasks.json
Vendored
+62
View File
@@ -0,0 +1,62 @@
{
"version": "2.0.0",
"tasks": [
{
// preLaunchTask for the emulator debug configurations. Idempotent: it
// exits at once when a device is already attached, so pressing F5 twice
// does not start two emulators.
"label": "Avvia emulatore Android",
"type": "shell",
"command": "powershell",
"args": [
"-NoProfile",
"-ExecutionPolicy", "Bypass",
"-File", "${workspaceFolder}/tool/start_emulator.ps1"
],
"problemMatcher": [],
"presentation": {
"reveal": "silent",
"panel": "shared",
"clear": true
}
},
{
"label": "Verifica (format, analyze, test, build)",
"type": "shell",
"command": "powershell",
"args": [
"-NoProfile",
"-ExecutionPolicy", "Bypass",
"-File", "${workspaceFolder}/tool/verify.ps1"
],
"group": { "kind": "build", "isDefault": true },
"problemMatcher": ["$dart-build_runner"]
},
{
"label": "Verifica rapida (senza build)",
"type": "shell",
"command": "powershell",
"args": [
"-NoProfile",
"-ExecutionPolicy", "Bypass",
"-File", "${workspaceFolder}/tool/verify.ps1",
"-SkipBuild"
],
"problemMatcher": []
},
{
"label": "Rigenera i frame radar dimostrativi",
"type": "shell",
"command": "python",
"args": ["${workspaceFolder}/tool/generate_mock_frames.py"],
"problemMatcher": []
},
{
"label": "Spegni emulatore",
"type": "shell",
"command": "adb",
"args": ["emu", "kill"],
"problemMatcher": []
}
]
}
Nuvolari/AndroidManifest.xml
-5
View File
@@ -1,5 +0,0 @@
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.nuvolari" android:versionCode="1">
<application android:allowBackup="true" android:icon="@mipmap/appicon" android:label="Nuvolari" android:supportsRtl="true"></application>
<uses-permission android:name="android.permission.INTERNET" />
</manifest>
Nuvolari/CLAUDE.md
+98
View File
@@ -0,0 +1,98 @@
# CLAUDE.md — Nuvolari
## Project
Cross-platform precipitation-radar app for the Piedmont region (Italy). Android first,
iOS later, single Flutter codebase. Region-scoped now (Piemonte) but extensible to other
regions via configuration.
## Scope
**Radar on a map, plus official alerts and rain notifications. Nothing else.**
In scope:
- Animated precipitation radar over an OpenStreetMap base map
- Saved places, municipality and coordinate search, and optional device location with a
live position marker; used to frame the map and later to anchor notifications
- Ground-station rain accumulations and 72-hour temperature from the ARPA realtime API,
published through the worker
- ARPA Piemonte official alert bulletin (XML-CAP), republished verbatim
- "Rain incoming" notifications by geographic cell
Explicitly out of scope — do not add these back without being asked:
- Weather forecasts of any kind
- Lightning
- Home-screen widget
- Advertising and consent flows
The app is currently free with **no advertising**. Ads may return later, so prefer data
sources that permit commercial use; do not adopt a non-commercial-only source on the
grounds that there are no ads today.
## Golden rules
- Code, identifiers and commit messages in English. UI text in Italian via ARB localization.
- Never commit secrets. Use .env + --dart-define; keep .gitignore updated.
- Never poll ARPA/DPC servers directly from the app: always go through our backend/CDN.
- Never store precise user locations server-side: rain notifications use geographic CELLS.
- Location is COARSE only. geolocator injects ACCESS_FINE_LOCATION; the app manifest
removes it with `tools:node="remove"`. Do not add it back without a feature that needs
it and a matching Data safety update. Saved places live in SharedPreferences on the
device and never leave it.
- Do not use ARPA/DPC name, logo or the word "ufficiale" in a way implying an official app.
## Architecture
- Monorepo: /app (Flutter), /backend (Python worker), /docs (detailed docs), /tool (scripts).
- Radar data via RadarSource interface with adapters:
DpcRadarSource (live, reads our CDN), ArpaRadarSource (stub, awaits access),
MockRadarSource (offline/demo). Active source chosen by region config + runtime flag.
- App reads PNG frames + manifest.json from CDN produced by the backend worker
(crop to Piemonte bbox, reproject to EPSG:3857).
## Data sources & licenses (attribution is mandatory on the Sources screen)
- Radar (active): Radar-DPC — base https://radar-api.protezionecivile.it/ ,
GET /findLastProductByType?type=VMI , POST /downloadProduct (GeoTIFF via presigned S3).
REQUIRE header `origin: https://radar.protezionecivile.it`. License CC BY-SA — credit
"Radar-DPC"; derivative data products must stay CC BY-SA. Docs: dpc-radar.readthedocs.io.
The rasters are on a **custom projection centred on Italy**, not EPSG:4326 or 3857, and
their GeoKeys are internally inconsistent — read the CRS from each file, never hardcode it.
- Radar (future): ARPA Piemonte (HDF5 ODIM, 5-minute volumes). The real-time access link
**must be requested by email** at info.meteo@arpa.piemonte.it — that request is the
project owner's to make. Adapter stays a disabled stub until it exists.
- Ground stations: ARPA realtime API, https://utility.arpa.piemonte.it/api_realtime —
no key, no registration. `/pie_anag` gives 374 stations with coordinates (286 with a
rain gauge); `/data_pie` gives hourly `cum_rain_1h/3h/6h/12h/24h`, temperature, wind,
snow and hydrometric level for the last 3 days. **It lags ~4.5 hours** — an observation
archive, not a live feed, and it must never be shown as current next to 5-minute radar.
Fetched by the worker, never by the app.
- ARPA licence: CC BY 4.0 per https://www.arpa.piemonte.it/note-legali, commercial use
permitted, credit "Fonte: Arpa Piemonte - www.arpa.piemonte.it". Both REST APIs link
that notice from their OpenAPI description. The radar page does not repeat it, so ask
ARPA to confirm it covers the radar volumes in the same email.
- Alerts: ARPA Piemonte XML-CAP bulletin at
https://www.arpa.piemonte.it/export/xmlcap/allerta.xml — reproduce alert levels WITHOUT
reinterpreting; link the official channel. Six level values, not four: VERDE, GIALLO,
ARANCIONE, ROSSO, plus BIANCO (avalanche scale out of season) and "-" (no data).
- Base map: OpenFreeMap (https://openfreemap.org), free OSM vector tiles with no API key
and no request limits. Mandatory credits: "© OpenMapTiles" and
"© OpenStreetMap contributors" (ODbL). OpenFreeMap's own credit is optional.
- Municipalities: 1180 Piedmont comuni bundled from Istat boundary shapefiles (CC BY 4.0),
generated by tool/generate_places.py. Offline search, no geocoding service. The source
DBF is UTF-8 despite appearances and the geometry is UTM 32N — see docs/data-sources.md
before regenerating.
- Launcher icon: a white cloud on the seed blue #1F6FB2, drawn by tool/generate_icon.py
and expanded by flutter_launcher_icons. Read the "Launcher icon" section of
docs/architecture.md before regenerating: the tool corrupts an Xcode build setting.
## Verification loop (run after each milestone)
- `dart format .` ; `flutter analyze` ; `flutter test` ; `flutter build appbundle`
- Backend: `python -m pytest` ; lint. Commit frequently with clear messages.
- `tool/verify.ps1` runs all of the above and skips stages that do not exist yet.
- Verify visually on the `nuvolari` AVD before calling a milestone done. Twice now,
running the app has caught defects that passing tests did not.
## Store / compliance targets
- Google Play: target API 36 (Android 16); closed testing 12 testers / 14 days;
Data safety section; prominent disclosure for location; signed AAB.
- No advertising, so no CMP and no IAB TCF obligations while that holds.
- iOS later: keep platform abstractions clean (privacy nutrition label to add).
## Docs to maintain in /docs
architecture.md, data-sources.md, licenses.md, stack-decisions.md, roadmap.md, privacy.md
Nuvolari/MainActivity.cs
-90
View File
@@ -1,90 +0,0 @@
using Android.App;
using Android.OS;
using Android.Gms.Maps;
using Android.Gms.Maps.Model;
using Android.Widget;
using Android.Locations;
using System.Threading.Tasks;
using System.Linq;
/*
* IDEE:
* Fare una versione molto base dell'app senza troppe funzionalità, giusto per mostrare una mappa.
* Fare poi una versione con più funzionalità, ma con pubblicità per guadagnare qualcosa da quello.
*/
namespace Nuvolari
{
[Activity(Label = "@string/app_name", MainLauncher = true)]
public class MainActivity : Activity, IOnMapReadyCallback
{
private MapFragment? mapFragment;
private GoogleMap? googleMap;
private SearchView? searchView;
protected override void OnCreate(Bundle? savedInstanceState)
{
base.OnCreate(savedInstanceState);
// Usa il layout personalizzato con SearchView e MapFragment
SetContentView(Resource.Layout.activity_main);
// Ottieni riferimenti ai componenti UI
searchView = FindViewById<SearchView>(Resource.Id.searchView);
mapFragment = FragmentManager.FindFragmentById(Resource.Id.map) as MapFragment;
mapFragment?.GetMapAsync(this);
// Gestione ricerca
if (searchView != null)
{
searchView.QueryTextSubmit += async (s, e) =>
{
var query = e?.Query ?? string.Empty;
await SearchAndMoveToLocationAsync(query);
searchView.ClearFocus();
};
}
}
public void OnMapReady(GoogleMap map)
{
googleMap = map;
// Imposta solo la navigazione base (scroll/zoom)
googleMap.UiSettings.CompassEnabled = false;
googleMap.UiSettings.MapToolbarEnabled = false;
googleMap.UiSettings.MyLocationButtonEnabled = false;
// Posizione iniziale: Milano
var position = new LatLng(45.4642, 9.19);
googleMap.MoveCamera(CameraUpdateFactory.NewLatLngZoom(position, 10));
}
private async Task SearchAndMoveToLocationAsync(string query)
{
if (string.IsNullOrWhiteSpace(query) || googleMap == null)
return;
var geocoder = new Geocoder(this);
#pragma warning disable CA1422 // Suppress warning for obsolete API on Android 33+
var addresses = await Task.Run(() => geocoder.GetFromLocationName(query, 1));
#pragma warning restore CA1422
var address = addresses?.FirstOrDefault();
if (address != null)
{
var latLng = new LatLng(address.Latitude, address.Longitude);
RunOnUiThread(() =>
{
googleMap?.AnimateCamera(CameraUpdateFactory.NewLatLngZoom(latLng, 10));
});
}
else
{
RunOnUiThread(() =>
{
Toast.MakeText(this, "Luogo non trovato", ToastLength.Short).Show();
});
}
}
}
}
Nuvolari/Nuvolari.csproj
-20
View File
@@ -1,20 +0,0 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net9.0-android</TargetFramework>
<SupportedOSPlatformVersion>21</SupportedOSPlatformVersion>
<OutputType>Exe</OutputType>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
<ApplicationId>com.companyname.Nuvolari</ApplicationId>
<ApplicationVersion>1</ApplicationVersion>
<ApplicationDisplayVersion>1.0</ApplicationDisplayVersion>
<!--
Enables trim analyzers and full trimming during Release mode.
To learn more, see: https://learn.microsoft.com/dotnet/core/deploying/trimming/trimming-options#trimming-granularity
-->
<TrimMode>full</TrimMode>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Xamarin.GooglePlayServices.Maps" Version="119.2.0.1" />
</ItemGroup>
</Project>
Nuvolari/Nuvolari.sln
-25
View File
@@ -1,25 +0,0 @@
Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 17
VisualStudioVersion = 17.13.35931.197 d17.13
MinimumVisualStudioVersion = 10.0.40219.1
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Nuvolari", "Nuvolari.csproj", "{B6CEEA40-2867-4F58-96EA-BB986DE9489C}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Release|Any CPU = Release|Any CPU
EndGlobalSection
GlobalSection(ProjectConfigurationPlatforms) = postSolution
{B6CEEA40-2867-4F58-96EA-BB986DE9489C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{B6CEEA40-2867-4F58-96EA-BB986DE9489C}.Debug|Any CPU.Build.0 = Debug|Any CPU
{B6CEEA40-2867-4F58-96EA-BB986DE9489C}.Release|Any CPU.ActiveCfg = Release|Any CPU
{B6CEEA40-2867-4F58-96EA-BB986DE9489C}.Release|Any CPU.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
EndGlobalSection
GlobalSection(ExtensibilityGlobals) = postSolution
SolutionGuid = {646B2C8A-0EA4-4133-AB5A-3C6DD1D72D94}
EndGlobalSection
EndGlobal
Nuvolari/README.md
+114
View File
@@ -0,0 +1,114 @@
# Nuvolari
Precipitation radar for Piedmont, Italy. Android first, iOS later, one Flutter codebase.
Radar imagery comes from the public **Radar-DPC** platform and weather alerts from the
**ARPA Piemonte** XML-CAP bulletin, drawn over an OpenStreetMap base map. The app is
free, with no advertising and no accounts.
**Scope**: radar, official alerts, rain notifications. No forecasts, no lightning, no
home-screen widget. See [CLAUDE.md](CLAUDE.md).
Nuvolari is an independent app. It is not affiliated with, endorsed by, or operated by
ARPA Piemonte or the Dipartimento della Protezione Civile. For civil-protection
purposes the official channels always prevail.
## Layout
```
app/ Flutter application (Dart package "nuvolari")
backend/ Python worker: fetches DPC rasters, crops, reprojects, renders PNG frames
docs/ architecture, data sources, licenses, stack decisions, roadmap, privacy
tool/ verification scripts
```
Start with [docs/architecture.md](docs/architecture.md), then
[docs/roadmap.md](docs/roadmap.md) for what is built and what is next.
## Toolchain
| Tool | Version |
|---|---|
| Flutter | 3.47.3 stable (Dart 3.13.3) |
| Android SDK | platform 36, build-tools 36.0.0, platform-tools |
| JDK | 21 |
| Python | 3.12+ (3.14 works; rasterio ships wheels for it) |
| Android NDK | 28.2.13676358 — pinned by `maplibre_gl`, not by this project |
A full toolchain plus a warm Gradle cache needs roughly **14 GB** of disk: Flutter
3 GB, Android SDK 2.5 GB (2 GB of which is the NDK the map plugin pins), the Gradle
cache 5 GB, and build output around 2 GB. `flutter clean` reclaims the last of those.
## Configuration
Secrets never enter the repository. Copy the template and fill it in:
```bash
cp env.example.json env.json # env.json is git-ignored
```
| Key | Purpose |
|---|---|
| `MAP_STYLE_URL` | MapLibre style URL. Empty uses the free OpenFreeMap style; `offline` forces the bundled no-network style. |
| `RADAR_MANIFEST_URL` | Base URL of the published `manifest.json`. |
| `RADAR_SOURCE` | `mock` (offline demo), `dpc` (live), `arpa` (disabled stub). |
| `REGION_ID` | Which region config to load. Defaults to `piemonte`. |
## Running
```bash
cd app
flutter run --dart-define-from-file=../env.json
```
With no `env.json` the app starts in demo mode: mock radar frames from assets on the
free OpenFreeMap base map. **No credentials are needed for anything** — OpenFreeMap has
no API key and no signup.
The radar frames work with no network at all. The base map needs one; run with
`--dart-define=MAP_STYLE_URL=offline` to drop it too and work entirely offline.
## Debugging in VS Code
Open the **`Nuvolari` folder** as the workspace root — the configurations in
`.vscode/` are relative to it. Then pick one in Run and Debug and press **F5**:
| Configuration | Use it for |
|---|---|
| **Nuvolari — debug (emulatore)** | Everyday work. Demo mode, no `env.json` needed, hot reload on save. |
| **Nuvolari — profile** | Judging animation smoothness. Debug builds run the Dart VM unoptimised, so the radar timeline always looks worse than it is — never assess it in debug. |
| **Nuvolari — debug con env.json** | Pointing the app at a live radar manifest or a different base map style. |
| **Nuvolari — debug su Windows** | Fast UI iteration with no emulator. The native map does not render here. |
| **Test — tutti** / **Test — file corrente** | Debugging tests with breakpoints. |
Every emulator configuration runs `tool/start_emulator.ps1` first, so F5 works from a
cold machine. The script exits immediately when a device is already attached, so
pressing F5 twice does not start two emulators.
`Ctrl+Shift+B` runs the full verification. Other tasks live under
**Terminal → Run Task**: quick verification, regenerating the demo radar frames, and
shutting the emulator down.
## Verifying
```powershell
.\tool\verify.ps1 # format, analyze, test, build, lint, pytest
.\tool\verify.ps1 -SkipBuild # fast inner loop
```
Stages whose target does not exist yet are skipped, so this runs from day one.
## Attribution
Radar-DPC (CC BY-SA) · Arpa Piemonte · © OpenStreetMap contributors (ODbL) ·
© OpenMapTiles · OpenFreeMap.
The credits are on the **Sources screen**, reached from the settings button over the
map. There is no permanent credit line on the map itself: the OSMF attribution
guidelines allow the licence information to sit behind an "About option in a menu" so
long as it stays findable, and a test asserts that route still exists.
See [docs/licenses.md](docs/licenses.md) for the obligations these carry — in
particular, the rendered radar frames are a derived product of CC BY-SA data and inherit
share-alike, and the OpenFreeMap style ships no `attribution` field, so the app has to
render the map credits itself.
Nuvolari/Resources/AboutResources.txt
-44
View File
@@ -1,44 +0,0 @@
Images, layout descriptions, binary blobs and string dictionaries can be included
in your application as resource files. Various Android APIs are designed to
operate on the resource IDs instead of dealing with images, strings or binary blobs
directly.
For example, a sample Android app that contains a user interface layout (main.xml),
an internationalization string table (strings.xml) and some icons (drawable-XXX/icon.png)
would keep its resources in the "Resources" directory of the application:
Resources/
drawable/
icon.png
layout/
main.xml
values/
strings.xml
In order to get the build system to recognize Android resources, set the build action to
"AndroidResource". The native Android APIs do not operate directly with filenames, but
instead operate on resource IDs. When you compile an Android application that uses resources,
the build system will package the resources for distribution and generate a class called "Resource"
(this is an Android convention) that contains the tokens for each one of the resources
included. For example, for the above Resources layout, this is what the Resource class would expose:
public class Resource {
public class Drawable {
public const int icon = 0x123;
}
public class Layout {
public const int main = 0x456;
}
public class Strings {
public const int first_string = 0xabc;
public const int second_string = 0xbcd;
}
}
You would then use Resource.Drawable.icon to reference the drawable/icon.png file, or
Resource.Layout.main to reference the layout/main.xml file, or Resource.Strings.first_string
to reference the first string in the dictionary file values/strings.xml.
Nuvolari/Resources/layout/activity_main.axml
-17
View File
@@ -1,17 +0,0 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<SearchView
android:id="@+id/searchView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:queryHint="Cerca città o luogo" />
<fragment
android:id="@+id/map"
android:name="com.google.android.gms.maps.MapFragment"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="1" />
</LinearLayout>
Nuvolari/Resources/layout/activity_main.xml
-13
View File
@@ -1,13 +0,0 @@
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:text="@string/app_text"
/>
</RelativeLayout>
Nuvolari/Resources/mipmap-anydpi-v26/appicon.xml
-4
View File
@@ -1,4 +0,0 @@
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
<background android:drawable="@mipmap/appicon_background" />
<foreground android:drawable="@mipmap/appicon_foreground" />
</adaptive-icon>
Nuvolari/Resources/mipmap-anydpi-v26/appicon_round.xml
-4
View File
@@ -1,4 +0,0 @@
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
<background android:drawable="@mipmap/appicon_background" />
<foreground android:drawable="@mipmap/appicon_foreground" />
</adaptive-icon>
Nuvolari/Resources/mipmap-hdpi/appicon.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 2.1 KiB

Nuvolari/Resources/mipmap-hdpi/appicon_background.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 97 B

Nuvolari/Resources/mipmap-hdpi/appicon_foreground.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 1.2 KiB

Nuvolari/Resources/mipmap-mdpi/appicon.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 1.5 KiB

Nuvolari/Resources/mipmap-mdpi/appicon_background.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 92 B

Nuvolari/Resources/mipmap-mdpi/appicon_foreground.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 1.2 KiB

Nuvolari/Resources/mipmap-xhdpi/appicon.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 3.0 KiB

Nuvolari/Resources/mipmap-xhdpi/appicon_background.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 100 B

Nuvolari/Resources/mipmap-xhdpi/appicon_foreground.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 1.8 KiB

Nuvolari/Resources/mipmap-xxhdpi/appicon.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 4.6 KiB

Nuvolari/Resources/mipmap-xxhdpi/appicon_background.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 108 B

Nuvolari/Resources/mipmap-xxhdpi/appicon_foreground.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 1.9 KiB

Nuvolari/Resources/mipmap-xxxhdpi/appicon.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 6.7 KiB

Nuvolari/Resources/mipmap-xxxhdpi/appicon_background.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 117 B

Nuvolari/Resources/mipmap-xxxhdpi/appicon_foreground.png
BIN
View File
Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 2.7 KiB

Nuvolari/Resources/values/strings.xml
-4
View File
@@ -1,4 +0,0 @@
<resources>
<string name="app_name">Nuvolari</string>
<string name="app_text">Hello, Android!</string>
</resources>
Nuvolari/app/.gitignore
+51
View File
@@ -0,0 +1,51 @@
# Miscellaneous
*.class
*.log
*.pyc
*.swp
.DS_Store
.atom/
.build/
.buildlog/
.history
.svn/
.swiftpm/
migrate_working_dir/
# IntelliJ related
*.iml
*.ipr
*.iws
.idea/
# The .vscode folder contains launch configuration and tasks you configure in
# VS Code which you may wish to be included in version control, so this line
# is commented out by default.
#.vscode/
# Flutter/Dart/Pub related
**/doc/api/
**/ios/Flutter/.last_build_id
.dart_tool/
.flutter-plugins-dependencies
.pub-cache/
.pub/
/build/
/coverage/
# Symbolication related
app.*.symbols
# Obfuscation related
app.*.map.json
# Android Studio will place build artifacts here
/android/app/debug
/android/app/profile
/android/app/release
# Widget Preview related
.widget_preview/
# Generated from lib/l10n/*.arb by the Flutter tool during `flutter pub get`.
/lib/l10n/app_localizations*.dart
Nuvolari/app/.metadata
+33
View File
@@ -0,0 +1,33 @@
# This file tracks properties of this Flutter project.
# Used by Flutter tool to assess capabilities and perform upgrades etc.
#
# This file should be version controlled and should not be manually edited.
version:
revision: "e8113bf45620cbeb8aff64947ee4c93e16adb4cf"
channel: "stable"
project_type: app
# Tracks metadata for the flutter migrate command
migration:
platforms:
- platform: root
create_revision: e8113bf45620cbeb8aff64947ee4c93e16adb4cf
base_revision: e8113bf45620cbeb8aff64947ee4c93e16adb4cf
- platform: android
create_revision: e8113bf45620cbeb8aff64947ee4c93e16adb4cf
base_revision: e8113bf45620cbeb8aff64947ee4c93e16adb4cf
- platform: ios
create_revision: e8113bf45620cbeb8aff64947ee4c93e16adb4cf
base_revision: e8113bf45620cbeb8aff64947ee4c93e16adb4cf
# User provided section
# List of Local paths (relative to this file) that should be
# ignored by the migrate tool.
#
# Files that are not part of the templates will be ignored by default.
unmanaged_files:
- 'lib/main.dart'
- 'ios/Runner.xcodeproj/project.pbxproj'
Nuvolari/app/analysis_options.yaml
+48
View File
@@ -0,0 +1,48 @@
include: package:flutter_lints/flutter.yaml
analyzer:
exclude:
- build/**
- android/**
- ios/**
# Generated from lib/l10n/*.arb by the Flutter tool.
- lib/l10n/app_localizations*.dart
errors:
# UI text must come from the ARB files. A literal string reaching a widget
# is untranslatable, so treat it as an error rather than a hint.
prefer_const_constructors: warning
todo: ignore
language:
strict-casts: true
strict-inference: true
strict-raw-types: true
linter:
rules:
# Correctness
- always_declare_return_types
- avoid_dynamic_calls
- avoid_slow_async_io
- cancel_subscriptions
- close_sinks
- comment_references
- literal_only_boolean_expressions
- no_adjacent_strings_in_list
- test_types_in_equals
- throw_in_finally
- unnecessary_statements
# Async correctness — the radar timeline is full of races between
# prefetching, scrubbing and lifecycle changes.
- discarded_futures
- unawaited_futures
# Style consistency
- directives_ordering
- prefer_final_locals
- prefer_single_quotes
- sort_child_properties_last
- unnecessary_parenthesis
- use_string_buffers
Nuvolari/app/android/.gitignore
+14
View File
@@ -0,0 +1,14 @@
gradle-wrapper.jar
/.gradle
/captures/
/gradlew
/gradlew.bat
/local.properties
GeneratedPluginRegistrant.java
.cxx/
# Remember to never publicly share your keystore.
# See https://flutter.dev/to/reference-keystore
key.properties
**/*.keystore
**/*.jks
Nuvolari/app/android/app/build.gradle.kts
+60
View File
@@ -0,0 +1,60 @@
plugins {
id("com.android.application")
// The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
id("dev.flutter.flutter-gradle-plugin")
}
android {
namespace = "it.nuvolari.app"
// SDK levels are pinned rather than inherited from `flutter.*` so that upgrading
// Flutter cannot silently move targetSdk. Google Play requires API 36 as of
// 2026-08-31, and that requirement is a release blocker, not a default.
compileSdk = 36
// Required even though this project has no native sources of its own:
// maplibre_gl pins ndkVersion 28.2.13676358 in its own build file, and
// AGP needs every module to agree on one NDK. Costs ~2 GB of SDK; do not
// drop it while the map plugin is a dependency.
ndkVersion = flutter.ndkVersion
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
defaultConfig {
applicationId = "it.nuvolari.app"
// minSdk 24 is the highest floor imposed by the planned dependencies:
// maplibre_gl needs 21, google_mobile_ads and firebase_messaging need 23.
minSdk = 24
targetSdk = 36
// Uses the version code from pubspec.yaml. When using split APKs, 1000 * ABI_VERSION
// is added automatically by Flutter. (https://developer.android.com/studio/build/configure-apk-splits#configure-APK-versions)
// You can force using the value of versionCode by specifying the `-P force-version-code-ignoring-abi=true`
// flag during build.
versionCode = flutter.versionCode
versionName = flutter.versionName
}
buildTypes {
release {
// Signed with the debug key so `flutter run --release` works during
// development. The real signing config is wired up in milestone 9 and
// reads from key.properties, which is git-ignored.
signingConfig = signingConfigs.getByName("debug")
}
}
}
kotlin {
compilerOptions {
jvmTarget = org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_17
}
}
flutter {
source = "../.."
}
Nuvolari/app/android/app/src/main/AndroidManifest.xml
+65
View File
@@ -0,0 +1,65 @@
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">
<!-- Flutter adds this to the debug and profile manifests only, so a
release build needs it declared here or every request fails. -->
<uses-permission android:name="android.permission.INTERNET"/>
<!-- Coarse only, deliberately. The app centres a map and picks the
nearest weather station, and stations are kilometres apart, so
street-level precision would buy nothing and cost a more
invasive permission. Never add ACCESS_FINE_LOCATION without a
feature that genuinely needs it. -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<!-- geolocator declares ACCESS_FINE_LOCATION in its own manifest, and the
merger pulls it in. Left alone the system dialog offers "Precise",
Play Services nags about Location Accuracy, and the Data safety form
has to declare precise location — all for accuracy this app never
uses. Removing it here keeps the declaration honest. -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
tools:node="remove"/>
<application
android:label="Nuvolari"
android:name="${applicationName}"
android:icon="@mipmap/ic_launcher">
<activity
android:name=".MainActivity"
android:exported="true"
android:launchMode="singleTop"
android:taskAffinity=""
android:theme="@style/LaunchTheme"
android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
android:hardwareAccelerated="true"
android:windowSoftInputMode="adjustResize">
<!-- Specifies an Android theme to apply to this Activity as soon as
the Android process has started. This theme is visible to the user
while the Flutter UI initializes. After that, this theme continues
to determine the Window background behind the Flutter UI. -->
<meta-data
android:name="io.flutter.embedding.android.NormalTheme"
android:resource="@style/NormalTheme"
/>
<intent-filter>
<action android:name="android.intent.action.MAIN"/>
<category android:name="android.intent.category.LAUNCHER"/>
</intent-filter>
</activity>
<!-- Don't delete the meta-data below.
This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->
<meta-data
android:name="flutterEmbedding"
android:value="2" />
</application>
<!-- Required to query activities that can process text, see:
https://developer.android.com/training/package-visibility and
https://developer.android.com/reference/android/content/Intent#ACTION_PROCESS_TEXT.
In particular, this is used by the Flutter engine in io.flutter.plugin.text.ProcessTextPlugin. -->
<queries>
<intent>
<action android:name="android.intent.action.PROCESS_TEXT"/>
<data android:mimeType="text/plain"/>
</intent>
</queries>
</manifest>
Nuvolari/app/android/app/src/main/kotlin/it/nuvolari/app/MainActivity.kt
+5
View File
@@ -0,0 +1,5 @@
package it.nuvolari.app
import io.flutter.embedding.android.FlutterActivity
class MainActivity : FlutterActivity()
Nuvolari/app/android/app/src/main/res/drawable-hdpi/ic_launcher_foreground.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.9 KiB

Nuvolari/app/android/app/src/main/res/drawable-hdpi/ic_launcher_monochrome.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.9 KiB

Nuvolari/app/android/app/src/main/res/drawable-mdpi/ic_launcher_foreground.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 974 B

Nuvolari/app/android/app/src/main/res/drawable-mdpi/ic_launcher_monochrome.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 974 B

Nuvolari/app/android/app/src/main/res/drawable-v21/launch_background.xml
+12
View File
@@ -0,0 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- Modify this file to customize your launch splash screen -->
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
<item android:drawable="?android:colorBackground" />
<!-- You can insert your own image assets here -->
<!-- <item>
<bitmap
android:gravity="center"
android:src="@mipmap/launch_image" />
</item> -->
</layer-list>
Nuvolari/app/android/app/src/main/res/drawable-xhdpi/ic_launcher_foreground.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.9 KiB

Nuvolari/app/android/app/src/main/res/drawable-xhdpi/ic_launcher_monochrome.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.9 KiB

Nuvolari/app/android/app/src/main/res/drawable-xxhdpi/ic_launcher_foreground.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.9 KiB

Nuvolari/app/android/app/src/main/res/drawable-xxhdpi/ic_launcher_monochrome.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.9 KiB

Nuvolari/app/android/app/src/main/res/drawable-xxxhdpi/ic_launcher_foreground.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 4.1 KiB

Nuvolari/app/android/app/src/main/res/drawable-xxxhdpi/ic_launcher_monochrome.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 4.1 KiB

Nuvolari/app/android/app/src/main/res/drawable/launch_background.xml
+12
View File
@@ -0,0 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- Modify this file to customize your launch splash screen -->
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
<item android:drawable="@android:color/white" />
<!-- You can insert your own image assets here -->
<!-- <item>
<bitmap
android:gravity="center"
android:src="@mipmap/launch_image" />
</item> -->
</layer-list>
Nuvolari/app/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
+14
View File
@@ -0,0 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
<background android:drawable="@color/ic_launcher_background"/>
<foreground>
<inset
android:drawable="@drawable/ic_launcher_foreground"
android:inset="0%" />
</foreground>
<monochrome>
<inset
android:drawable="@drawable/ic_launcher_monochrome"
android:inset="0%" />
</monochrome>
</adaptive-icon>
Nuvolari/app/android/app/src/main/res/mipmap-hdpi/ic_launcher.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.3 KiB

Nuvolari/app/android/app/src/main/res/mipmap-mdpi/ic_launcher.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 776 B

Nuvolari/app/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.5 KiB

Nuvolari/app/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.3 KiB

Nuvolari/app/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.9 KiB

Nuvolari/app/android/app/src/main/res/values-night/styles.xml
+18
View File
@@ -0,0 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is on -->
<style name="LaunchTheme" parent="@android:style/Theme.Black.NoTitleBar">
<!-- Show a splash screen on the activity. Automatically removed when
the Flutter engine draws its first frame -->
<item name="android:windowBackground">@drawable/launch_background</item>
</style>
<!-- Theme applied to the Android Window as soon as the process has started.
This theme determines the color of the Android Window while your
Flutter UI initializes, as well as behind your Flutter UI while its
running.
This Theme is only used starting with V2 of Flutter's Android embedding. -->
<style name="NormalTheme" parent="@android:style/Theme.Black.NoTitleBar">
<item name="android:windowBackground">?android:colorBackground</item>
</style>
</resources>
Nuvolari/Resources/values/ic_launcher_background.xml → Nuvolari/app/android/app/src/main/res/values/colors.xml
+1 -1
View File
@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<color name="ic_launcher_background">#2C3E50</color>
<color name="ic_launcher_background">#1F6FB2</color>
</resources>
Nuvolari/app/android/app/src/main/res/values/styles.xml
+18
View File
@@ -0,0 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is off -->
<style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
<!-- Show a splash screen on the activity. Automatically removed when
the Flutter engine draws its first frame -->
<item name="android:windowBackground">@drawable/launch_background</item>
</style>
<!-- Theme applied to the Android Window as soon as the process has started.
This theme determines the color of the Android Window while your
Flutter UI initializes, as well as behind your Flutter UI while its
running.
This Theme is only used starting with V2 of Flutter's Android embedding. -->
<style name="NormalTheme" parent="@android:style/Theme.Light.NoTitleBar">
<item name="android:windowBackground">?android:colorBackground</item>
</style>
</resources>
Nuvolari/app/android/app/src/profile/AndroidManifest.xml
+7
View File
@@ -0,0 +1,7 @@
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<!-- The INTERNET permission is required for development. Specifically,
the Flutter tool needs it to communicate with the running application
to allow setting breakpoints, to provide hot reload, etc.
-->
<uses-permission android:name="android.permission.INTERNET"/>
</manifest>
Nuvolari/app/android/build.gradle.kts
+24
View File
@@ -0,0 +1,24 @@
allprojects {
repositories {
google()
mavenCentral()
}
}
val newBuildDir: Directory =
rootProject.layout.buildDirectory
.dir("../../build")
.get()
rootProject.layout.buildDirectory.value(newBuildDir)
subprojects {
val newSubprojectBuildDir: Directory = newBuildDir.dir(project.name)
project.layout.buildDirectory.value(newSubprojectBuildDir)
}
subprojects {
project.evaluationDependsOn(":app")
}
tasks.register<Delete>("clean") {
delete(rootProject.layout.buildDirectory)
}
Nuvolari/app/android/gradle.properties
+6
View File
@@ -0,0 +1,6 @@
org.gradle.jvmargs=-Xmx8G -XX:MaxMetaspaceSize=4G -XX:ReservedCodeCacheSize=512m -XX:+HeapDumpOnOutOfMemoryError
android.useAndroidX=true
# This newDsl flag was added by the Flutter template
android.newDsl=false
# This builtInKotlin flag was added by the Flutter template
android.builtInKotlin=false
Nuvolari/app/android/gradle/wrapper/gradle-wrapper.properties
Vendored
+5
View File
@@ -0,0 +1,5 @@
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-all.zip
Nuvolari/app/android/settings.gradle.kts
+26
View File
@@ -0,0 +1,26 @@
pluginManagement {
val flutterSdkPath =
run {
val properties = java.util.Properties()
file("local.properties").inputStream().use { properties.load(it) }
val flutterSdkPath = properties.getProperty("flutter.sdk")
require(flutterSdkPath != null) { "flutter.sdk not set in local.properties" }
flutterSdkPath
}
includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
repositories {
google()
mavenCentral()
gradlePluginPortal()
}
}
plugins {
id("dev.flutter.flutter-plugin-loader") version "1.0.0"
id("com.android.application") version "9.1.0" apply false
id("org.jetbrains.kotlin.android") version "2.4.0" apply false
}
include(":app")
Nuvolari/app/assets/icon/icon.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 14 KiB

Nuvolari/app/assets/icon/icon_foreground.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 9.1 KiB

Nuvolari/app/assets/mock/frames/1768478400000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.8 KiB

Nuvolari/app/assets/mock/frames/1768478700000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.9 KiB

Nuvolari/app/assets/mock/frames/1768479000000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.1 KiB

Nuvolari/app/assets/mock/frames/1768479300000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.4 KiB

Nuvolari/app/assets/mock/frames/1768479600000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.7 KiB

Nuvolari/app/assets/mock/frames/1768479900000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.9 KiB

Nuvolari/app/assets/mock/frames/1768480200000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.1 KiB

Nuvolari/app/assets/mock/frames/1768480500000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.3 KiB

Nuvolari/app/assets/mock/frames/1768480800000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.3 KiB

Nuvolari/app/assets/mock/frames/1768481100000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.3 KiB

Nuvolari/app/assets/mock/frames/1768481400000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.4 KiB

Nuvolari/app/assets/mock/frames/1768481700000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.5 KiB

Nuvolari/app/assets/mock/frames/1768482000000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.4 KiB

Nuvolari/app/assets/mock/frames/1768482300000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.4 KiB

Nuvolari/app/assets/mock/frames/1768482600000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.3 KiB

Nuvolari/app/assets/mock/frames/1768482900000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.3 KiB

Nuvolari/app/assets/mock/frames/1768483200000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.2 KiB

Nuvolari/app/assets/mock/frames/1768483500000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.1 KiB

Nuvolari/app/assets/mock/frames/1768483800000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.0 KiB

Nuvolari/app/assets/mock/frames/1768484100000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.9 KiB

Nuvolari/app/assets/mock/frames/1768484400000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.6 KiB

Nuvolari/app/assets/mock/frames/1768484700000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.5 KiB

Nuvolari/app/assets/mock/frames/1768485000000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.4 KiB

Nuvolari/app/assets/mock/frames/1768485300000.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.3 KiB

Nuvolari/app/assets/mock/manifest.json
+148
View File
@@ -0,0 +1,148 @@
{
"region": "piemonte",
"product": "VMI",
"generatedAt": 1768485300000,
"bbox": [
6.55,
43.95,
9.3,
46.55
],
"crs": "EPSG:3857",
"frames": [
{
"ts": 1768478400000,
"url": "frames/1768478400000.png"
},
{
"ts": 1768478700000,
"url": "frames/1768478700000.png"
},
{
"ts": 1768479000000,
"url": "frames/1768479000000.png"
},
{
"ts": 1768479300000,
"url": "frames/1768479300000.png"
},
{
"ts": 1768479600000,
"url": "frames/1768479600000.png"
},
{
"ts": 1768479900000,
"url": "frames/1768479900000.png"
},
{
"ts": 1768480200000,
"url": "frames/1768480200000.png"
},
{
"ts": 1768480500000,
"url": "frames/1768480500000.png"
},
{
"ts": 1768480800000,
"url": "frames/1768480800000.png"
},
{
"ts": 1768481100000,
"url": "frames/1768481100000.png"
},
{
"ts": 1768481400000,
"url": "frames/1768481400000.png"
},
{
"ts": 1768481700000,
"url": "frames/1768481700000.png"
},
{
"ts": 1768482000000,
"url": "frames/1768482000000.png"
},
{
"ts": 1768482300000,
"url": "frames/1768482300000.png"
},
{
"ts": 1768482600000,
"url": "frames/1768482600000.png"
},
{
"ts": 1768482900000,
"url": "frames/1768482900000.png"
},
{
"ts": 1768483200000,
"url": "frames/1768483200000.png"
},
{
"ts": 1768483500000,
"url": "frames/1768483500000.png"
},
{
"ts": 1768483800000,
"url": "frames/1768483800000.png"
},
{
"ts": 1768484100000,
"url": "frames/1768484100000.png"
},
{
"ts": 1768484400000,
"url": "frames/1768484400000.png"
},
{
"ts": 1768484700000,
"url": "frames/1768484700000.png"
},
{
"ts": 1768485000000,
"url": "frames/1768485000000.png"
},
{
"ts": 1768485300000,
"url": "frames/1768485300000.png"
}
],
"legend": {
"unit": "dBZ",
"stops": [
{
"value": 5,
"color": "#4FA3D1"
},
{
"value": 10,
"color": "#2E7DBE"
},
{
"value": 20,
"color": "#35A64A"
},
{
"value": 30,
"color": "#E9D22B"
},
{
"value": 35,
"color": "#EC8B2A"
},
{
"value": 40,
"color": "#D63B28"
},
{
"value": 45,
"color": "#A61E1E"
},
{
"value": 50,
"color": "#B028B0"
}
]
},
"attribution": "Dati dimostrativi generati da tool/generate_mock_frames.py"
}
Nuvolari/app/assets/regions/piemonte.json
+173
View File
@@ -0,0 +1,173 @@
{
"id": "piemonte",
"displayName": "Piemonte",
"timeZone": "Europe/Rome",
"bbox": [
6.55,
43.95,
9.3,
46.55
],
"map": {
"center": [
7.95,
45.25
],
"zoom": {
"min": 6.0,
"max": 13.0,
"initial": 7.2
}
},
"sources": {
"radar": {
"defaultAdapter": "mock",
"availableAdapters": [
"mock",
"dpc"
],
"product": "VMI",
"frameIntervalMinutes": 5
},
"alerts": {
"defaultAdapter": "arpaCap",
"availableAdapters": [
"arpaCap"
],
"officialBulletinUrl": "https://www.arpa.piemonte.it/rischi_naturali/boll/bollettino_allerta.pdf"
}
},
"alertZones": [
{
"code": "Piem-A",
"name": "Toce",
"provinces": [
"NO",
"VB"
]
},
{
"code": "Piem-B",
"name": "Val Sesia, Cervo e Chiusella",
"provinces": [
"BI",
"NO",
"TO",
"VC"
]
},
{
"code": "Piem-C",
"name": "Valli Orco, Lanzo, bassa Val Susa e Sangone",
"provinces": [
"TO"
]
},
{
"code": "Piem-D",
"name": "Alta Val Susa, Valli Chisone, Pellice e Po",
"provinces": [
"CN",
"TO"
]
},
{
"code": "Piem-E",
"name": "Valli Varaita, Maira e Stura",
"provinces": [
"CN"
]
},
{
"code": "Piem-F",
"name": "Valle Tanaro",
"provinces": [
"CN"
]
},
{
"code": "Piem-G",
"name": "Belbo e Bormida",
"provinces": [
"AL",
"AT",
"CN"
]
},
{
"code": "Piem-H",
"name": "Scrivia",
"provinces": [
"AL"
]
},
{
"code": "Piem-I",
"name": "Pianura Settentrionale",
"provinces": [
"AL",
"AT",
"BI",
"NO",
"TO",
"VC"
]
},
{
"code": "Piem-L",
"name": "Pianura Torinese e Colline",
"provinces": [
"AL",
"AT",
"CN",
"TO"
]
},
{
"code": "Piem-M",
"name": "Pianura Cuneese",
"provinces": [
"CN",
"TO"
]
}
],
"attributions": [
{
"id": "dpc",
"text": "Radar-DPC — Dipartimento della Protezione Civile",
"license": "CC BY-SA",
"url": "https://radar.protezionecivile.it"
},
{
"id": "arpa",
"text": "Arpa Piemonte",
"license": null,
"url": "https://www.arpa.piemonte.it"
},
{
"id": "osm",
"text": "© OpenStreetMap contributors",
"license": "ODbL",
"url": "https://www.openstreetmap.org/copyright"
},
{
"id": "openmaptiles",
"text": "© OpenMapTiles",
"license": "BSD 3-Clause",
"url": "https://openmaptiles.org/"
},
{
"id": "openfreemap",
"text": "OpenFreeMap",
"license": "MIT",
"url": "https://openfreemap.org/"
},
{
"id": "istat",
"text": "Istat — Confini delle unità amministrative",
"license": "CC BY 4.0",
"url": "https://www.istat.it/notizia/confini-delle-unita-amministrative-a-fini-statistici/"
}
]
}
Nuvolari/app/assets/regions/piemonte_comuni.json
+1
View File
File diff suppressed because one or more lines are too long
Nuvolari/app/ios/.gitignore
+34
View File
@@ -0,0 +1,34 @@
**/dgph
*.mode1v3
*.mode2v3
*.moved-aside
*.pbxuser
*.perspectivev3
**/*sync/
.sconsign.dblite
.tags*
**/.vagrant/
**/DerivedData/
Icon?
**/Pods/
**/.symlinks/
profile
xcuserdata
**/.generated/
Flutter/App.framework
Flutter/Flutter.framework
Flutter/Flutter.podspec
Flutter/Generated.xcconfig
Flutter/ephemeral/
Flutter/app.flx
Flutter/app.zip
Flutter/flutter_assets/
Flutter/flutter_export_environment.sh
ServiceDefinitions.json
Runner/GeneratedPluginRegistrant.*
# Exceptions to above rules.
!default.mode1v3
!default.mode2v3
!default.pbxuser
!default.perspectivev3
Nuvolari/app/ios/Flutter/AppFrameworkInfo.plist
+24
View File
@@ -0,0 +1,24 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>
<key>CFBundleExecutable</key>
<string>App</string>
<key>CFBundleIdentifier</key>
<string>io.flutter.flutter.app</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>App</string>
<key>CFBundlePackageType</key>
<string>FMWK</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleSignature</key>
<string>????</string>
<key>CFBundleVersion</key>
<string>1.0</string>
</dict>
</plist>
Nuvolari/app/ios/Flutter/Debug.xcconfig
+1
View File
@@ -0,0 +1 @@
#include "Generated.xcconfig"
Nuvolari/app/ios/Flutter/Release.xcconfig
+1
View File
@@ -0,0 +1 @@
#include "Generated.xcconfig"

Some files were not shown because too many files have changed in this diff Show More