joe/common-cents-api
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

updated readme

Browse source
This commit is contained in:
Joe Arndt 2026-02-09 22:20:16 -06:00
parent 5e3f2ac7ee
commit 7c42d44e88
1 changed files with 12 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

13
README.md
View file

@ -2,6 +2,9 @@
REST API for expense tracking and budgeting.
## Project setup
> Note: use no less than a currently supported LTS version of Node.
Install dependencies:
```bash
npm install
```
@ -12,7 +15,7 @@ By default, the API looks for a locally running Postgres instance, which can be
docker run --name common-cents-db -e POSTGRES_USER=common-cents -e POSTGRES_PASSWORD=CommonCents_123! -p 5432:5432 -d postgres
```
Alternatively, a DB configuration can be provided through an environment file placed in the root directory (`common-cents-api/.env`):
Alternatively, an external Postgres can be configured through an environment file placed in the root directory (`common-cents-api/.env`):
```text
# .env
DB_SYNC=true # should be false for production environment
@ -28,6 +31,14 @@ Once the DB is configured/running, the API can be started:
npm run start:dev
```
Default port (`3000`) can also be set in the `.env` file by setting `PORT=xxxx`.
## Bruno
The included `bruno` folder contains a collection of calls to make it more convenient to interact with the API. Local calls assume the default NestJS port (`3000`) is being used.
### What's Bruno?
[Bruno](https://www.usebruno.com/) is alternative to Postman, unlike Postman it's fully open source, requires no subscription or account and collections are easily version controlled.
## Resources
Check out a few resources that may come in handy when working with NestJS: