Back to Projects
PraiaFinder
Next.js
FastAPI
Python
Data analysis
AI-assisted
A Next.js and FastAPI app that scores Portuguese beaches from 0 to 10 using weather and sea forecasts. The idea, the data sourcing and the analysis of the results are mine; the code was generated with AI.


Find the right beach in Portugal for what you want to do.
Who did what
The idea is mine, and so are the choice of the data sources and the analysis of the results. The application code (Next.js frontend and FastAPI backend) was generated with AI, so I present this as an AI-assisted project and not as code I wrote.
Project overview
Instead of showing raw meteorological data (wind in knots, swell period, and so on), PraiaFinder turns the forecasts into a simple 0 to 10 score that depends on what you want to do:
- For surfers: high waves and strong offshore winds give a high score.
- For families: calm water, low wind and warm temperatures give a high score.
How it works
- A Python data pipeline fetches weather and sea forecasts for the beaches from external APIs and scores them.
- A FastAPI backend serves the scores, and a Next.js frontend shows them on a map.
- The pipeline retries failed requests and caches results to avoid calling the external APIs too often.
