공학박사 권경안

✍️ Node.js + Express로 나만의 Todo API 서버 만들기 — 깃허브 템플릿 공유 본문

Programming

✍️ Node.js + Express로 나만의 Todo API 서버 만들기 — 깃허브 템플릿 공유

Karl Kwon 2025. 4. 22. 09:57

Node.js + Express로 나만의 Todo API 서버 만들기 — 깃허브 템플릿 공유

안녕하세요! 이번 글에서는 Node.js와 Express를 사용해서 심플한 Todo API 서버를 만들고,
GitHub에 템플릿으로 정리한 과정을 소개합니다.

이 프로젝트는 백엔드 API 학습과 포트폴리오용으로 아주 적합합니다.


💡 프로젝트 소개

Node.js와 Express를 활용해 JSON 파일을 기반으로 할 일 목록을 CRUD 방식으로 관리하는 서버를 만들었습니다.

주요 기능:

  • 할 일 추가 (Create)
  • 할 일 조회 (Read)
  • 할 일 수정 (Update)
  • 할 일 삭제 (Delete)

추가적으로:

  • Jest + Supertest를 활용한 테스트 자동화
  • Dockerfile을 활용한 컨테이너화
  • GitHub Actions를 이용한 CI/CD 자동 배포 흐름도 구성했습니다.

⚙️ 사용 기술

  • Node.js 20.x
  • Express.js
  • Jest / Supertest
  • Docker
  • GitHub Actions

📦 프로젝트 구조

controllers/
data/
routes/
tests/
server.js
Dockerfile
package.json

데이터는 todos.json 파일을 통해 로컬 저장됩니다.


🐳 Docker 빌드 예시

docker build -t todo-api .
docker run -p 3000:3000 todo-api

🚀 GitHub Actions

main 브랜치 푸시 시:

  • 자동 테스트 실행
  • Docker 이미지 빌드 & GitHub Container Registry 푸시

📂 GitHub 링크

👉 https://github.com/kyeongan/express-todo-api-template

누구나 clone 해서 바로 사용할 수 있는 템플릿 형태입니다!
포트폴리오, 학습용으로 활용해보세요.


🏁 마무리

Node.js 백엔드 입문자와 포트폴리오 준비하는 분들께 추천하는 작은 프로젝트입니다.
다양한 추가 기능을 연습하면서 발전시켜보세요!

도움이 되셨다면 GitHub Star 도 눌러주세요 :)