Skip to content

Commit fcf7227

Browse files
authored
Update README.md
1 parent 5359ac3 commit fcf7227

File tree

1 file changed

+315
-2
lines changed

1 file changed

+315
-2
lines changed

README.md

Lines changed: 315 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,318 @@
1-
## node-and-express-api
1+
# Saddam-rest-api
2+
Free Open source REST API built with | Nodejs + Express + Mongodb ⚡️ Made with developer experience first Prettier + VSCode setup.
23

3-
Creating REST API with Node.js, Express, and MongoDB, JSON Web Token (JWT) Authentication, Mongoose, Middleware Authentication
4+
> + C.R.U.D, Filter, Paginate, Sort and Search API
45
6+
# Table of contents
57

8+
- [Author](#Author)
9+
- [Demo](#Demo)
10+
- [Technologies](#Technologies)
11+
- [Contributing](#Contributing)
12+
- [Status](#status)
13+
- [Features](#Features)
14+
- [Related Projects](#Related_Projects)
15+
- [Support](#Support)
16+
- [Feedback](#Feedback)
17+
- [Run Locally](#Run_Locally)
18+
- [Screenshots](#Screenshots)
19+
- [Environment Variables](#Environment)
20+
- [Deployment](#Deployment)
21+
22+
# Author
23+
24+
### <a href="https://github.com/saddamarbaa">@Saddam Arbaa</a>
25+
26+
# Technologies
27+
28+
- Node.js
29+
- Express
30+
- MongoDB
31+
- JSON Web Token (JWT)
32+
- bcryptjs
33+
- Heroku Hosting
34+
35+
36+
# Demo
37+
### <a href="https://saddam-next-ecommerce.vercel.app/">Live Demo </a>
38+
### <a href="https://github.com/saddamarbaa/node-express-rest-api"> Back-End API REPO</a>
39+
### <a href="https://saddam-rest-api.herokuapp.com">LIVE API Demo</a>
40+
41+
#### Testing Email: testverstion@gmail.com
42+
#### Testing Password: 12345test
43+
44+
45+
# Features
46+
47+
##### (Users)
48+
- Complete user authentication
49+
- Users can sign in
50+
- Users can sign out
51+
- Users can verify email
52+
- Users can Change Password
53+
- View all products
54+
- View products detail
55+
- Filter products by category
56+
- Search for products
57+
- Add products to their basket
58+
- Checkout total payment
59+
- Checkout order page
60+
- Products pagination
61+
62+
##### (Admin)
63+
- Complete Admin Authorization
64+
- Add products
65+
- Update products
66+
- Delete products
67+
- Limit Products
68+
- Add Users
69+
- Update Users
70+
- Delete Users
71+
- Update User Role
72+
73+
74+
# Environment
75+
- To run this project, you will need to add the following environment variables to your .env file (check environment.config.js file for more examples)
76+
77+
- MONGODB_CONNECTION_STRING
78+
- TOKEN_SECRET
79+
- WEBSITE_URL
80+
- API_VERSION ="v1"
81+
- JWT_EXPIRE_TIME
82+
- SEND_GRID_API_KEY
83+
- ADMIN_SEND_GRID_EMAIL
84+
- ADMIN_ROLE
85+
- ADMIN_EMAIL
86+
- NODE_ENV = 'development'
87+
- CLIENT_URL
88+
- ACCESS_TOKEN_SECRET_KEY
89+
- REFRESH_TOKEN_SECRET_KEY
90+
- ACCESS_TOKEN_KEY_EXPIRE_TIME
91+
- REFRESH_TOKEN_KEY_EXPIRE_TIME
92+
93+
94+
# Contributing
95+
96+
Contributions are always welcome!
97+
98+
99+
# Deployment
100+
To deploy this project on Heroku Flow the Flowing documentation <a href="https://devcenter.heroku.com/articles/deploying-nodejs">Deploying Node.js Apps on Heroku</a>
101+
102+
# Related_Projects
103+
104+
105+
### Twitter API built with | Nodejs + Express + Mongodb
106+
107+
#### <a href="https://twitter-clone-app-saddam.herokuapp.com/">LIVE API Demo</a>
108+
#### <a href="https://github.com/saddamarbaa/twitter-clone-api">API REPO</a>
109+
#### <a href="https://github.com/saddamarbaa/twitter-clone-app">Front-End REPO</a>
110+
#### <a href="https://twitter-clone-saddam.netlify.app/">LIVE Webside DEMO </a>
111+
#### <a href="https://www.loom.com/share/545edc779b964d2095f9dd5a5d22a0b4"> Live Video Demo </a>
112+
113+
114+
### Blog API built with | Nodejs + Express + Mongodb
115+
116+
#### <a href="https://blog-post-api-sadam.herokuapp.com">LIVE API</a>
117+
#### <a href="https://github.com/saddamarbaa/blog-api">API REPO</a>
118+
#### <a href="https://github.com/saddamarbaa/blog-api">Front-End REPO</a>
119+
#### <a href="https://saddamarbaa-blog.netlify.app/"> LIVE Webside DEMO </a>
120+
121+
122+
# Support
123+
124+
For support, email saddamarbaas@gmail.com.
125+
126+
# Feedback
127+
128+
If you have any feedback, please reach out to me at saddamarbaas@gmail.com
129+
130+
Twitter
131+
https://twitter.com/ArbaaSaddam/
132+
133+
Linkedin.
134+
https://www.linkedin.com/in/saddamarbaa/
135+
136+
Github
137+
https://github.com/saddamarbaa
138+
139+
Instagram
140+
https://www.instagram.com/saddam.dev/
141+
142+
Facebook
143+
https://www.facebook.com/saddam.arbaa
144+
145+
146+
# Run_Locally
147+
148+
Clone the project
149+
150+
```bash
151+
https://github.com/saddamarbaa/node-express-rest-api
152+
```
153+
154+
Go to the project directory
155+
156+
```bash
157+
cd node-express-rest-api
158+
```
159+
160+
Install dependencies
161+
162+
```bash
163+
yarn install
164+
# or
165+
npm install
166+
```
167+
168+
Start the server
169+
170+
```bash
171+
node app.js
172+
or
173+
nodemon app.js
174+
```
175+
176+
177+
178+
# Status
179+
180+
Project is: in progress I'm working on it in my free time
181+
182+
183+
184+
185+
# Screenshots
186+
187+
## Signup Page
188+
![image](https://user-images.githubusercontent.com/51326421/168418001-ddf09448-6f3a-4d0c-9ce8-1e691666dd13.png)
189+
190+
191+
![image](https://user-images.githubusercontent.com/51326421/168420032-1339ad80-24e0-4f06-bb90-630256ae2973.png)
192+
193+
194+
195+
196+
## LogIn Page
197+
198+
![image](https://user-images.githubusercontent.com/51326421/168417978-8ad90e22-44e0-4961-aa1d-6a3ad8d235d4.png)
199+
200+
![image](https://user-images.githubusercontent.com/51326421/168419975-7eee5c8a-d3cb-4e1f-a50f-0f01f6d85650.png)
201+
202+
203+
204+
## Forgot Password Page
205+
206+
![image](https://user-images.githubusercontent.com/51326421/168418030-7e87c64b-55ed-4c89-a899-0e9434b147bc.png)
207+
208+
![image](https://user-images.githubusercontent.com/51326421/168419992-59d97525-031a-41d7-ba31-53ab1a75c1e6.png)
209+
210+
211+
![image](https://user-images.githubusercontent.com/51326421/168418079-ec2ca89d-2997-4e44-af34-4bbe2a06bf29.png)
212+
213+
## Reset Password email Link
214+
![image](https://user-images.githubusercontent.com/51326421/168418151-aaf3a8d4-03b5-4011-aff2-7b42e53a4425.png)
215+
216+
217+
## Reset Password Page
218+
219+
![image](https://user-images.githubusercontent.com/51326421/168418261-2c4cb6cb-42b6-44b3-8b98-b91da31f2252.png)
220+
221+
222+
![image](https://user-images.githubusercontent.com/51326421/168420074-88a7ff38-e9cc-421c-917f-3070223021fb.png)
223+
224+
225+
226+
## Update Profile Page
227+
![image](https://user-images.githubusercontent.com/51326421/168419955-ca2231ab-457f-4d48-8188-025e2a931d45.png)
228+
229+
230+
231+
## Home Page
232+
233+
![image](https://user-images.githubusercontent.com/51326421/168419207-cf99c8c8-3032-4441-bbc9-2aecb7b6df78.png)
234+
235+
236+
## Home Page (Filter by category(Bookks))
237+
238+
![image](https://user-images.githubusercontent.com/51326421/168419224-aa093745-8923-4c01-95b3-54897b275fde.png)
239+
240+
241+
242+
## Home Page (Filter by category(Sports))
243+
244+
![image](https://user-images.githubusercontent.com/51326421/168419258-dc20e307-92f0-4be6-903d-8312bc6ae6b2.png)
245+
246+
247+
248+
## Home Page (Filter by category(Toys))
249+
![image](https://user-images.githubusercontent.com/51326421/168419286-d0912456-8aac-4d70-8693-a9923fc3af48.png)
250+
251+
252+
253+
## Home Page (Filter by category(Men's clothing))
254+
![image](https://user-images.githubusercontent.com/51326421/168419300-bed584b1-db33-457e-bd91-c24a8e416473.png)
255+
256+
257+
258+
## Home Page (Search Product (Jewelery))
259+
![image](https://user-images.githubusercontent.com/51326421/168419621-b392a53a-cbc4-4173-ac75-1500b68ad356.png)
260+
261+
262+
## Product Detail Page
263+
264+
![image](https://user-images.githubusercontent.com/51326421/168417430-4be9f4e9-2f3c-468d-a587-21ea0e0edafe.png)
265+
266+
267+
268+
269+
## Shopping Cart Page
270+
![image](https://user-images.githubusercontent.com/51326421/168417498-f5ab4afa-e964-43f9-81ac-87ead9c9852d.png)
271+
272+
273+
274+
## Orders Page
275+
![image](https://user-images.githubusercontent.com/51326421/168417573-f9358b57-ba05-4ae9-a613-a034ec5230bc.png)
276+
277+
278+
279+
280+
## Admin Products Page
281+
![image](https://user-images.githubusercontent.com/51326421/168417651-8ea633e1-13c6-4707-8127-69e6e133ff58.png)
282+
283+
284+
285+
## Admin Users Page
286+
![image](https://user-images.githubusercontent.com/51326421/168417796-0140add5-abf7-490a-9aee-094bd86754d3.png)
287+
288+
## Admin Users Table Page
289+
![image](https://user-images.githubusercontent.com/51326421/168417814-c7e859f3-6a79-48df-8560-0bb2de53bfc4.png)
290+
291+
292+
293+
294+
## Admin Add Product Page
295+
![image](https://user-images.githubusercontent.com/51326421/168417851-4396ddbd-d7cb-4d50-bb78-df36b4583c8e.png)
296+
297+
298+
![image](https://user-images.githubusercontent.com/51326421/168419929-81f17f43-dbbd-4d80-b7fb-2d614e88b607.png)
299+
300+
301+
302+
## Admin Update Product Page
303+
304+
![image](https://user-images.githubusercontent.com/51326421/168417887-ff0a9660-4955-474f-a87f-4f0aaeebc2e8.png)
305+
306+
307+
308+
## Admin Add User Page
309+
![image](https://user-images.githubusercontent.com/51326421/168417951-0f454bc3-fb59-42cb-b764-2059135a6043.png)
310+
311+
312+
![image](https://user-images.githubusercontent.com/51326421/168419886-f8be1530-7131-4625-b044-292fbc6ed3c3.png)
313+
314+
315+
316+
## Admin Update User Page
317+
318+
![image](https://user-images.githubusercontent.com/51326421/168417927-567f47b6-748e-4fc1-9ea0-a45d71f5c660.png)

0 commit comments

Comments
 (0)