Skip to content

Commit 64d741c

Browse files
committed
feat: added readme
1 parent d936c9b commit 64d741c

File tree

1 file changed

+85
-0
lines changed

1 file changed

+85
-0
lines changed

README.md

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
# NestJS + NextJS Starter Project by Kir-Dev
2+
3+
This is a starter project for a fullstack application using NestJS and NextJS.
4+
It includes a basic setup for a NestJS as backend and a NextJS as frontend,
5+
including shadcn/ui, ESLint, Prettier, and GitHub Actions.
6+
7+
## Getting Started
8+
9+
### Prerequisites
10+
11+
- Node.js 20
12+
- Yarn 1.22
13+
14+
### Installation
15+
16+
You only need to install dependencies in the root directory.
17+
18+
```bash
19+
yarn install
20+
```
21+
22+
### Linter and Formatter Configuration
23+
24+
It is a must to use ESLint and Prettier in this project.
25+
26+
Set up ESLint and Prettier in your IDE and check `fix on save` or `format on save` options.
27+
28+
You can run the following commands to check linting and formatting issues.
29+
30+
```bash
31+
yarn lint
32+
# or
33+
yarn lint:fix
34+
```
35+
36+
```bash
37+
yarn format:check
38+
# or
39+
yarn format
40+
```
41+
42+
### Development
43+
44+
You can run the backend and frontend separately.
45+
46+
```bash
47+
yarn start:backend # Starts on http://localhost:3001
48+
```
49+
50+
```bash
51+
yarn start:frontend # Starts on http://localhost:3000
52+
```
53+
54+
### After Development
55+
56+
You can build the frontend and run the application.
57+
58+
```bash
59+
yarn build:frontend
60+
```
61+
62+
Or build the backend.
63+
64+
```bash
65+
yarn build:backend
66+
```
67+
68+
There are recommended GitHub Actions workflows for this setup, which will fail if one of the following commands fails:
69+
70+
```bash
71+
yarn lint
72+
```
73+
74+
```bash
75+
yarn format:check
76+
```
77+
78+
```bash
79+
yarn build:backend
80+
```
81+
82+
## Happy Coding!
83+
84+
85+

0 commit comments

Comments
 (0)