https://github.com/wastingnotime/contacts-backend-nodejs-express
This repository maintain a nodejs/express application that is part of "contacts" project, an initiative to explore technologies features.
https://github.com/wastingnotime/contacts-backend-nodejs-express
crud-api expressjs migrations nodejs sequelize sqlite
Last synced: 4 months ago
JSON representation
This repository maintain a nodejs/express application that is part of "contacts" project, an initiative to explore technologies features.
- Host: GitHub
- URL: https://github.com/wastingnotime/contacts-backend-nodejs-express
- Owner: wastingnotime
- License: mit
- Created: 2020-06-17T13:04:10.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2026-01-24T12:52:11.000Z (5 months ago)
- Last Synced: 2026-01-25T00:38:56.657Z (5 months ago)
- Topics: crud-api, expressjs, migrations, nodejs, sequelize, sqlite
- Language: JavaScript
- Homepage:
- Size: 407 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# contacts-backend-nodejs-express
**contacts-backend-nodejs-express** is part of "contacts" project that is an initiative where we try to explore frontend and backend implementations in order to better understand it cutting-edge features. This repository presents a nodejs rest API sample.
## status
This repository belongs to the Contacts reference initiative started in 2020.
Its purpose was to understand how different stacks shape design decisions around the same domain model.
As of 2026, this project is frozen.
The exploration phase has been completed.
My current focus is depth, invariants, and system coherence rather than stack comparison.
This code remains as historical reference.
## stack
* node 22
* express
* sqlite
* sequelize
## features
* migrations
## get started (linux only)
### option 1 - use latest docker image from dockerhub
execute the remote docker image
```
docker run -p 8010:8010 wastingnotime/contacts-backend-nodejs-express
```
### option 2 - build and run a local docker image
build a local docker image
```
docker build --tag contacts-backend-nodejs-express .
```
execute the local docker image
```
docker run -p 8010:8010 contacts-backend-nodejs-express
```
### option 3 - execute from source code
- first, install node 21 +, if you don't have it on your computer: [how to install node](https://nodejs.org/en/download/package-manager)
- go to root of solution and execute the commands below
set environment for development
```
cp .env_example .env
```
set node version
```
nvm use
```
install deps
```
npm i
```
and then run the application
```
npm start
```
## testing
create a new contact
```
curl --request POST \
--url http://localhost:8010/contacts \
--header 'Content-Type: application/json' \
--data '{
"firstName": "Albert",
"lastName": "Einstein",
"phoneNumber": "2222-1111"
}'
```
retrieve existing contacts
```
curl --request GET \
--url http://localhost:8010/contacts
```
more examples and details about requests on (link) *to be defined
# observations
* multi-stage docker building do not reduce so much but it's kept because can help to segregate build and runtime for future improvements as security concerns.