A web application built for Union Station Homeless Services (USHS), a nonprofit organization committed to helping homeless individuals and families rebuild their lives in the San Gabriel Valley. This web app aims to centralize and streamline the everyday workflows of the USHS team: collecting landlord/unit information, browsing housing unit data, referring renter candidates, and tracking the status of the renter candidate process.
Built with: MongoDB, Express.js, Vite + React, Bun, and Firebase.
Before you can start developing, you'll need to install these tools:
- Bun - this is our JavaScript runtime
- Postman or Insomnium (no account BS) - (optional) helpful tool for testing API routes
- MongoDB Community - (optional) only needed if you wish to run the database locally
To get the backend running, run these commands from the root directory of the project:
- Copy the backend
.envfile (see Slack) into thebackenddirectory cd backendbun installto install dependencies- If running the database locally, make sure to start
mongod bun run startto start the backend
To get the Vite development server running, run these commands from the root directory of the project:
cd frontendbun installto install dependenciesbun run startto run the development server
In both the backend and frontend directories, these commands are available for linting and formatting code:
bun run format- reformats the code without any lintingbun run lint-fix- fixes auto-fixable lint errors and reformats the codebun run lint-check- just check for lint errors or code style issues without modifying any files (e.g. for Git pre-commit hook and CI/CD check)