|
| 1 | +# StoreZero: E-Commerce Application |
| 2 | + |
1 | 3 | <p align="center"> |
2 | 4 | <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="120" alt="Nest Logo" /></a> |
3 | 5 | </p> |
4 | 6 |
|
5 | 7 | [circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456 |
6 | 8 | [circleci-url]: https://circleci.com/gh/nestjs/nest |
7 | 9 |
|
8 | | - <p align="center">A progressive <a href="http://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p> |
| 10 | + <p align="center">A robust e-commerce application built with **NestJS** , **Prisma** , **PostgreSQL** , and **TypeScript** . This project includes user authentication, CRUD operations, and more.</p> |
9 | 11 | <p align="center"> |
10 | 12 | <a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/v/@nestjs/core.svg" alt="NPM Version" /></a> |
11 | 13 | <a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/l/@nestjs/core.svg" alt="Package License" /></a> |
12 | 14 | <a href="https://github.com/building-for-fun/StoreZero/actions/workflows/secret-scan.yml" target="_blank"><img src="https://github.com/building-for-fun/StoreZero/actions/workflows/secret-scan.yml/badge.svg" alt="Secret Scan" /></a> |
13 | 15 |
|
14 | | -</p> |
15 | | - <!--[](https://opencollective.com/nest#backer) |
16 | | - [](https://opencollective.com/nest#sponsor)--> |
| 16 | +--- |
17 | 17 |
|
18 | | -## Description |
| 18 | +## 🚀 Tech Stack |
19 | 19 |
|
20 | | -[Nest](https://github.com/nestjs/nest) framework TypeScript starter repository. |
| 20 | + |
| 21 | + |
| 22 | + |
| 23 | + |
| 24 | + |
| 25 | + |
21 | 26 |
|
22 | | -## Project setup |
| 27 | +--- |
23 | 28 |
|
24 | | -```bash |
25 | | -$ npm install |
26 | | -``` |
| 29 | +## 🛠 Installation |
27 | 30 |
|
28 | | -## Compile and run the project |
| 31 | +1. **Clone the repository**: |
| 32 | + ```bash |
| 33 | + git clone https://github.com/building-for-fun/StoreZero.git |
| 34 | + cd StoreZero |
| 35 | + ``` |
29 | 36 |
|
30 | | -```bash |
31 | | -# development |
32 | | -$ npm run start |
| 37 | +Install dependencies: |
33 | 38 |
|
34 | | -# watch mode |
35 | | -$ npm run start:dev |
| 39 | + ```bash |
| 40 | + npm install |
| 41 | + ``` |
36 | 42 |
|
37 | | -# production mode |
38 | | -$ npm run start:prod |
39 | | -``` |
| 43 | +Install NestJS CLI (if not already installed): |
40 | 44 |
|
41 | | -## Run tests |
| 45 | + ```bash |
| 46 | + npm install -g @nestjs/cli |
| 47 | + ``` |
42 | 48 |
|
43 | | -```bash |
44 | | -# unit tests |
45 | | -$ npm run test |
| 49 | +<hr/> |
| 50 | + |
| 51 | +🔑 Environment Variables |
| 52 | +Copy the `.env.example` file to .env: |
| 53 | + |
| 54 | + ```bash |
| 55 | + cp .env.example .env |
| 56 | + ``` |
| 57 | + |
| 58 | +Update the .env file with your configuration (e.g., database URL, JWT secret, etc.). |
46 | 59 |
|
47 | | -# e2e tests |
48 | | -$ npm run test:e2e |
49 | 60 |
|
50 | | -# test coverage |
51 | | -$ npm run test:cov |
| 61 | +<hr/> |
| 62 | + |
| 63 | +▶️ Running the Application |
| 64 | +Without Docker |
| 65 | + |
| 66 | +Start the application: |
| 67 | + |
| 68 | +```bash |
| 69 | +npm run start:dev |
52 | 70 | ``` |
53 | 71 |
|
54 | | -## Deployment |
| 72 | +The application will be available at http://localhost:3000. |
55 | 73 |
|
56 | | -When you're ready to deploy your NestJS application to production, there are some key steps you can take to ensure it runs as efficiently as possible. Check out the [deployment documentation](https://docs.nestjs.com/deployment) for more information. |
57 | 74 |
|
58 | | -If you are looking for a cloud-based platform to deploy your NestJS application, check out [Mau](https://mau.nestjs.com), our official platform for deploying NestJS applications on AWS. Mau makes deployment straightforward and fast, requiring just a few simple steps: |
| 75 | +With Docker |
| 76 | +Build and start the Docker containers: |
59 | 77 |
|
60 | 78 | ```bash |
61 | | -$ npm install -g mau |
62 | | -$ mau deploy |
| 79 | +docker-compose up --build |
63 | 80 | ``` |
64 | 81 |
|
65 | | -With Mau, you can deploy your application in just a few clicks, allowing you to focus on building features rather than managing infrastructure. |
| 82 | +The application will be available at http://localhost:3000. |
| 83 | + |
66 | 84 |
|
67 | | -## Resources |
| 85 | +<hr/> |
68 | 86 |
|
69 | | -Check out a few resources that may come in handy when working with NestJS: |
| 87 | +📦 Prisma Migrations |
70 | 88 |
|
71 | | -- Visit the [NestJS Documentation](https://docs.nestjs.com) to learn more about the framework. |
72 | | -- For questions and support, please visit our [Discord channel](https://discord.gg/G7Qnnhy). |
73 | | -- To dive deeper and get more hands-on experience, check out our official video [courses](https://courses.nestjs.com/). |
74 | | -- Deploy your application to AWS with the help of [NestJS Mau](https://mau.nestjs.com) in just a few clicks. |
75 | | -- Visualize your application graph and interact with the NestJS application in real-time using [NestJS Devtools](https://devtools.nestjs.com). |
76 | | -- Need help with your project (part-time to full-time)? Check out our official [enterprise support](https://enterprise.nestjs.com). |
77 | | -- To stay in the loop and get updates, follow us on [X](https://x.com/nestframework) and [LinkedIn](https://linkedin.com/company/nestjs). |
78 | | -- Looking for a job, or have a job to offer? Check out our official [Jobs board](https://jobs.nestjs.com). |
| 89 | +Run Prisma migrations: |
79 | 90 |
|
80 | | -## Support |
| 91 | + ```bash |
| 92 | + npx prisma migrate dev --name <migration-name> |
| 93 | + ``` |
81 | 94 |
|
82 | | -Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support). |
| 95 | +Generate Prisma client: |
83 | 96 |
|
84 | | -## Stay in touch |
| 97 | + ```bash |
| 98 | + npx prisma generate |
| 99 | + ``` |
85 | 100 |
|
86 | | -- Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec) |
87 | | -- Website - [https://nestjs.com](https://nestjs.com/) |
88 | | -- Twitter - [@nestframework](https://twitter.com/nestframework) |
| 101 | +<hr/> |
| 102 | + |
| 103 | +🧪 Running Tests |
| 104 | +Run the tests using Jest: |
| 105 | + |
| 106 | +```bash |
| 107 | +npm run test |
| 108 | +``` |
89 | 109 |
|
90 | | -## License |
| 110 | +<hr/> |
91 | 111 |
|
92 | | -Nest is [MIT licensed](https://github.com/nestjs/nest/blob/master/LICENSE). |
| 112 | +📄 License |
| 113 | +This project is licensed under the MIT License. |
0 commit comments