https://github.com/nadjiel/fixer-web
A communication platform for citizens and city hall to manage and fix city issues
https://github.com/nadjiel/fixer-web
communication forum issue-tracker public-utility reactjs web
Last synced: 4 months ago
JSON representation
A communication platform for citizens and city hall to manage and fix city issues
- Host: GitHub
- URL: https://github.com/nadjiel/fixer-web
- Owner: nadjiel
- Created: 2025-11-02T13:43:41.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-11-30T21:43:54.000Z (7 months ago)
- Last Synced: 2025-12-01T22:59:31.690Z (7 months ago)
- Topics: communication, forum, issue-tracker, public-utility, reactjs, web
- Language: JavaScript
- Homepage: https://fixer-web-production.up.railway.app/signin
- Size: 340 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Fixer
Fixer is a website that helps stablishing communication about urban issues between citizens and city hall, aiming to increase the efficiency with which problems are solved, while also helping at prioritization through a user "Support" system similar to the one present on sites like Stack Overflow.
## 👀 Accessing
You can access the live version in this Railway deploy: **[https://fixer.up.railway.app/](https://fixer.up.railway.app/)**.
## ▶️ Executing
### With Docker Compose
This project provides a `Dockerfile` that can be used to build its image and later execute it. To build using it, the following command can be used:
```sh
docker build --build-arg VITE_API_URL=http://localhost:8000 --build-arg VITE_BASE_URL=/ --tag .
```
When building, the `VITE_API_URL` and `VITE_BASE_URL` variables can be used to define both the URL of the [Fixer API](https://github.com/nadjiel/fixer-api) instance to use and what base route to expect in the deploy of this app.
Once the image is available locally, run it using:
```sh
docker run --detach \
--name \
--env-file .env \
--publish :80 \
:
```
### With Plain Node
If you prefer not to use Docker, Fixer can also be executed directly with Node.js:
```sh
npm install
npm run start
```
Remember to configure your `.env` file in advance. Refer to `.env.example` for expected variables.
## 🧑💻 Developing
This application includes both a `Dockerfile` for building a production-ready image and a `docker-compose.yml` for spinning up a full environment that includes the database, API and an instance of this app.
Before running the development server, make sure to install dependencies and configure environment variables based on the `.env.example` file. To run the dev server, use:
```sh
npm run dev
```
## 🫂 Thank You
This project was initially developed in a [Hackathon](https://marcoslviana.github.io/Hackathao/) by these awesome people:
* [Daniel O. Sousa](https://github.com/nadjiel)
* [Ives Furtado](https://github.com/ivesfg1)
* [Jonathan César](https://github.com/Jonathaannn)
* [Lyzzandro Dualamo](https://github.com/lyzzandro)
* [Pedro Júnior](https://github.com/Pedro35803)
* [Ulisses Pereira](https://github.com/yolisses)
Thank you for checking out Fixer!