/citylayers_app

Upgrade of CityLayers to 2.0.0

Primary LanguageJavaScript

Contributors Forks Stargazers Issues MIT License LinkedIn


Logo

City Layers

City Layers: Citizen Mapping as a Practice of City-Making

Technische Universitat Wien
Department of Visual Culture, School of Architecture and Planning

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. License
  4. Contact
  5. Acknowledgments

About The Project

Citizens are invited to contribute to a collective network of data on citizens’ spatial needs by sharing their thoughts on a range of urban phenomena.

Intro

CityLayers at its current stage:

(Check the video to get a full picture)

(back to top)

Built With

(back to top)

Project files

(back to top)

Getting Started for developers

Refer to API quickstart when developing the frontend part 🙃

Prerequisites

(back to top)

Setup of the development environment

  • Clone or fork the repo:

    git clone https://github.com/citylayers/WebApp24.git
  • Install all the prerequisites

  • Go to the root folder

    cd WebApp24
  • Install composer dependencies:

    composer install
  • Configure setup file:

    cp .env.example .env

    for Windows:

    copy .env.example .env
  • Clear the cache

    php artisan config:clear
  • Generate a new encryption key

    php artisan key:generate
  • Go to XAMPP, start Apache and MySQL Server

  • Go to http://localhost:8080/phpmyadmin/ (replace 8080 with your Apache server port from config file)

  • Create a dataset citylayers_db if it does not exist create dataset

  • Select your dataset; go to privileges db privileges

  • Create a new user, add pwd, give all the necessary rights

  • Set environmental variables in the config file: DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=citylayers_db DB_USERNAME=your_database_username DB_PASSWORD=your_database_password

    your_database_username and your_database_password are the values you created in the previous step, when adding a user account with the rights to access the database

  • Run database migrations and seeders:

    php artisan migrate --seed
  • Copy Update query and run it in the SQL tab: Running SQL query

  • Run the server:

    php artisan serve
  • Install node dependencies

    npm install
  • Run the local version

      npm run dev

    or

    npm run build

    or

    npx vite

(back to top)

Deployment

Check the documentation for server deployment.

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Lovro - @website - e-mail - LinkedIn
Firas Safieddine - @website - e-mail - LinkedIn
Stasja - @website - e-mail - LinkedIn

(back to top)

Acknowledgments

(back to top)