Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

136 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SecurCity 2.0

Version 2.0.0 GitHub stars Contributors Forks Open issues Repository size Last commit License

Software Engineering Top 6 percent recognition

SecurCity video demo

Click the image to watch the video demo.

A cross-platform safety companion for smarter, safer urban navigation. Built as Group 10's Software Engineering project at the University of Trento.

Recognition. SecurCity was one of the six finalist projects in the University of Trento's 100 Progetti per Trento challenge. Read the University article.

Table of Contents 📖

Overview

SecurCity helps citizens reach destinations safely and confidently through intelligent route planning, real-time alerts, and collaboration with municipal operators.

The system combines a REST API, an operator-facing web interface, and a citizen-facing mobile app.

Demo

Watch the complete SecurCity video demo on YouTube.

Key features

  • Safe route generation via Google Maps and real-time data
  • Email and Google Sign-In authentication
  • Anonymous crime reports and emergency-contact support
  • Municipal dashboard for tokens, sensors, alerts, and report management
  • Modular web, mobile, and backend architecture

Architecture

Web app (React + Expo)          Mobile app (React Native + Expo)
             \                         /
              \                       /
               -------- REST API -------
                         Express + Mongoose

Both clients communicate with the same API for route generation, user actions, and map data. The safe-routing logic is documented in BackEnd/README.md.

Project structure

FrontEnd/
  WebApp/          # React-based interface for municipal operators
  MobileApp/        # React Native app for citizens
BackEnd/            # Node.js REST API server
assets/             # Logos and static assets
LICENSE.txt         # AGPL-3.0 license
README.md           # Project overview

Each component has its own README with implementation-specific notes.

Getting started

Prerequisites

  • Node.js and npm
  • An instance of MongoDB for the backend
  • Google OAuth, Maps, and SendGrid credentials where the corresponding features are enabled

Configure the backend

cd BackEnd
cp .env.example .env

Fill in your own values in .env. Never commit credentials or a real administrator code.

Web app

cd FrontEnd/WebApp
npm install
npx expo start -w

See FrontEnd/WebApp/README.md for details. The historical course deployment is available at is-project-securcity.onrender.com.

Mobile app

cd FrontEnd/MobileApp
npm install
npx expo start

See FrontEnd/MobileApp/README.md for device and emulator notes.

Backend API

cd BackEnd
npm install
npm run dev

See BackEnd/README.md for endpoints and safe-routing details.

Recognition

SecurCity placed third among the projects selected from the Software Engineering course and reached the top 6% of 100 Progetti per il Comune di Trento. Read the official University of Trento press article.

Acknowledgments

SecurCity was developed for the Software Engineering course at the University of Trento under the supervision of Prof. Sandro Luigi Fiore, Prof. Chiara Di Francescomarino, and Prof. Marco Robol. We thank them for their guidance, technical feedback, and support throughout the project.

The project took part in 100 Progetti per il Comune di Trento, an initiative promoted by the University of Trento and the Municipality of Trento within the UniCittà protocol. SecurCity placed third among the projects selected from the Software Engineering course and reached the top 6% of the overall initiative. See the official University of Trento press article.

UniCittà      Comune di Trento

Team

Group 10

Member GitHub LinkedIn Email
Andrea Lo Iacono @ADreLOI Andrea Lo Iacono [email protected]
Matthew De Marco @MattDema Matthew De Marco [email protected]
Andrea Pezzo @AndreaP2203 Andrea Pezzo [email protected]

License

This project is licensed under the AGPL-3.0 License.

The name SecurCity, its logo, and related branding are not covered by the AGPL license and remain Copyright 2025 Matthew De Marco, Andrea Lo Iacono, and Andrea Pezzo.

Back to Top
Back to Top

About

A cross-platform personal-safety system for safer urban navigation, anonymous reporting, real-time alerts, and municipal operations; a finalist in UniTrento's 100 Progetti per Trento challenge.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages