NestJS Hackathon Starter

Ahmet Uysal — Fri, 22 May 2020 10:13:22 +0000

Hi, I am a senior computer science student from Koç University, Istanbul. I am interested in web technologies and computer science education.

My Project

I have joined many hackathons throughout my collage years. I noticed creating an initial project and implementing generic features such as authentication and database connection takes several hours in every competition, which limits time I can put into the unique parts of the project. However, these features are also important and brings your team points in evaluation process :)

So, I decided to create a simple starter project and it grew more and more after each hackathon. Currently, it implements authentication, email verification, Swagger documentation, request validation, password reset and more.

Building it taught me many things about Typescript, NestJS, unit testing, backend development, and software engineering in general. Feel free to use it on your projects and even add new features with pull requests.

Link to Code

ahmetuysal / nest-hackathon-starter

Hackathon starter project for NestJS. Includes TypeORM, email verification, Passport-JWT authentication, Swagger and more

Nest Hackathon Starter

This project contains boilerplate for creating APIs using Nest, a progressive Node.js framework for building efficient and scalable server-side applications.

It is mostly built to be used as a starting point in hackathons and implements common operations such as sign up, JWT authentication, mail validation, model validation and database access.

You can also look at my Angular Hackathon Starter template that shares the same contract with this API.

Features

PostgreSQL with TypeORM
JWT Authentication
Mail Verification
Mail Change
Password Reset
Request Validation
Customizable Mail Templates
Swagger API Documentation
Security Techniques
Logger

Getting Started

Installation

Make sure that you have Node.js(>= 8.9.0) installed.
Clone this repository by running git clone https://github.com/ahmetuysal/nest-hackathon-starter.git <YOUR_PROJECT_NAME> or directly create your own GitHub repository using this template.
Move to the appropriate directory: cd <YOUR_PROJECT_NAME>.
Run npm install to install dependencies.

Configuration Files

TypeORM Configurations

This template uses Postgres by…

View on GitHub

How I built it

I followed the official NestJS documentation to implement most of the features. Feel free to open an issue if you have any questions, feedback or feature requests :)

DEV Community: Ahmet Uysal