From de911c4833d3b58be3469415e1c1211c408a9a05 Mon Sep 17 00:00:00 2001 From: Ariel Costas Guerrero <94913521+arielcostas@users.noreply.github.com> Date: Tue, 4 Mar 2025 12:43:35 +0100 Subject: Add licence --- README.md | 73 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..750af83 --- /dev/null +++ b/README.md @@ -0,0 +1,73 @@ +# UrbanoVigo Web + +UrbanoVigo Web is a web application designed to help users find bus stops and arrival times for urban buses in Vigo, Spain. + +## Features + +- **Real-time Bus Arrival Estimates**: Get real-time estimates for bus arrivals at various stops. +- **Bus Stop List**: View a list of all bus stops, search for specific stops, and mark your favorite stops. +- **Interactive Map**: View bus stops on an interactive map. +- **Settings**: Customize the theme (light/dark mode) and table style (regular/grouped). + +## Technologies Used + +- **Frontend**: React 19, react-router, TypeScript, Vite +- **Backend** (.NET): + - Azure Functions + - [Costasdev.VigoTransitApi](https://github.com/arielcostas/urbanovigo) +- **Mapping**: + - [Leaflet](https://leafletjs.com/) via [React-Leaflet](https://react-leaflet.js.org/) + - [Leaflet Locate Control](https://github.com/domoritz/leaflet-locatecontrol) + - [Leaflet Marker Cluster](https://github.com/Leaflet/Leaflet.markercluster) +- **Styling**: CSS, Fontsource Variable + +## Getting Started + +### Prerequisites + +- Node 22 and npm +- .NET 8 SDK +- Azure Static Web Apps CLI (swa) `npm install -g @azure/static-web-apps-cli` + +### Installation + +1. Clone the repository: + ```sh + git clone https://github.com/arielcostas/urbanovigo-web.git + cd urbanovigo-web + ``` + +2. Install frontend dependencies: + ```sh + npm install + ``` + +3. Install backend dependencies: + ```sh + cd Backend + dotnet restore + cd .. + ``` + +### Running the Application + +1. Start the application with the Static Web Apps CLI: + ```sh + swa start + ``` + +3. Open your browser and navigate to `http://localhost:5173`. + +### Deployment + +The application is configured to be deployed to Azure Static Web Apps via GitHub Actions. To deploy the application to Azure by yourself, remove it in your fork and create a new "Static Web App" resource in the Azure Portal with the repository and branch you want to deploy. + +## Contributing + +Contributions are welcome! Please open an issue or submit a pull request. + +## License + +This project is licensed under the BSD 3-Clause licence, meaning you can do whatever you want with it as long as you include the original copyright and license notice. + +Note that the data served by the application is obtained from [datos.vigo.org](https://datos.vigo.org) under the [Open Data Commons Attribution License](https://opendefinition.org/licenses/odc-by/), so you must comply with the terms of that license if you use the data in your own projects. \ No newline at end of file -- cgit v1.3