Skip to content
Snippets Groups Projects
Select Git revision
  • main default protected
  • feat/simple-poi-backend
2 results
Name Last commit Last update
app
bootstrap
config
database
graphql
public
resources/views
routes
storage
tests
.env.example
.gitignore
.gitlab-ci.yml
.styleci.yml
README.md
_lighthouse_ide_helper.php
artisan
composer.json
composer.lock
phpunit.xml
programmatic-types.graphql
schema-directives.graphql
README.md

Fab City Map Backend

The Fab City Hamburg Map is a web application, which displays POIs on an interactive map in the browser with some meta data (like description or tags). It can be used as a standalone website or embedded into an existing website or CMS (like Wordpress).

Architecture

This project is a typical two-tier web application (which means it has a frontend running on the browser of the user and a centralised backend running on a web server). The frontend talks to the backend via a GraphQl API.

Frontend

The frontend is a JavaScript single page application which runs in most modern browsers like recent versions of Firefox, Chrome and Safari. It uses the following frameworks and libraries:

  • Typescript
  • React
  • Snowpack
  • Leaflet
  • Tailwind

Backend

The tech stack for the backend was picked to be as simple as possible, so it can be deployed on many servers without special or exotic requirements. This PHP application should run on most webspaces and servers that offer PHP 7.4+. All the data is saved in a SQLite database, which again reduces requirements for the hosting environment.

  • PHP
  • Laravel Lumen
  • Lighthouse
  • GraphQl

Installation

  • Download the backend application and extract it to your webspace web root
  • Create a new environment file .env (you can look at .env.example to see what should be included) and enter the proper values for your setup

Start backend

  • You need to serve the public folder via a webserver. Either upload it to a PHP capable server, or for development purposes you can run php -S localhost:8000 -t public