Skip to content

Commit 70cefa0

Browse files
committed
shifting to version v1.1.0 is cool.
- docs updated and fixed. - ui updated. - logo changed.
1 parent f432dce commit 70cefa0

File tree

8 files changed

+142
-116
lines changed

8 files changed

+142
-116
lines changed

docs/.vitepress/config.js

+8-4
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,21 @@ export default {
33
base: '/gen3-express/',
44
title: "Gen3 Express",
55
head: [['meta', { name: 'google-site-verification', content: '8ITIfF1pu9VrQOnXrnDnYZqCILQjm5wgdxYLt056ApI' }]],
6-
description: "A gen3 tool to generate get started express app.",
6+
description: "A gen3 tool to generate express app boilerplate.",
77
themeConfig: {
88
siteTitle: "Gen3 Express",
9-
logo: "https://www.cdnlogo.com/logos/h/71/hashnode.svg",
10-
socialLinks: [
9+
logo: "/icons/logo.blue.png",
10+
socialLinks: [
1111
{ icon: "github", link: "https://github.com/OurCodeBase" },
1212
{ icon: "instagram", link: "https://instagram.com/aspandapo" },
1313
{ icon: "youtube", link: "https://m.youtube.com/@OurCodeBase" }
1414
],
15+
nav: [
16+
{ text: "History", link: "https://github.com/OurCodeBase/gen3-express/commits/main/" },
17+
{ text: "Changelogs", link: "/changelogs" }
18+
],
1519
footer: {
16-
copyright: "Copyright © 2024-present OurCodeBase",
20+
copyright: "All Right Reserved @OurCodeBase",
1721
},
1822
}
1923
};

docs/.vitepress/theme/custom.css

+5-10
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
1-
@import url(https://fonts.googleapis.com/css?family=Space+Mono:regular,italic,700,700italic);
2-
@import url(https://fonts.googleapis.com/css?family=Space+Grotesk:regular,italic,700,700italic);
1+
@import url('https://fonts.googleapis.com/css2?family=Sora:[email protected]&family=Space+Mono:ital,wght@0,400;0,700;1,400;1,700&display=swap');
32

43
:root {
54
--vp-c-brand: #ff7340;
@@ -11,12 +10,8 @@
1110

1211
--vp-c-sponsor: #fd1d7c;
1312

14-
/* Typography */
15-
--vp-font-family-base: "Space Grotesk", "Inter var experimental", "Inter var",
16-
-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell,
17-
"Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif;
18-
13+
/* Typography */
14+
--vp-font-family-base: "Sora";
1915
/* Code Snippet font */
20-
--vp-font-family-mono: "Space Mono", Menlo, Monaco, Consolas, "Courier New",
21-
monospace;
22-
}
16+
--vp-font-family-mono: "Space Mono";
17+
}

docs/changelogs.md

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Changelogs
2+
You can check most latest changlogs at [commits](https://github.com/OurCodeBase/gen3-express/commits/main/) or [versions](https://github.com/OurCodeBase/gen3-express/releases) sections in github.
3+
4+
## Changelogs 1.1.0
5+
tui has been implemented to gen3-express.
6+
- used signale to implement tui.
7+
- changes many things in gen3-express file.
8+
9+
## Changelogs 1.0.1
10+
- nets module has been shifted from `/nets.js` to the utils folder `/utils/nets.js`.
11+
- docs have also been updated.

docs/documentation.md

+85
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
# Gen3 Express
2+
A gen3 tool to generate express app boilerplate.
3+
4+
## Changelogs 1.1.0
5+
tui has been implemented to gen3-express.
6+
- used signale to implement tui.
7+
- changes many things in gen3-express file.
8+
9+
## Acknowledgements
10+
You need to know atleast basics about these things.
11+
- [NodeJS](https://nodejs.org/docs/latest/api/)
12+
- [ExpressJS](https://expressjs.com/en/5x/api.html)
13+
- [Embedded JS](https://ejs.co/)
14+
15+
## Installation
16+
You can install and generate an express app using this tool in two approaches. Here I'm generating an app with name `my-app`, you can name to it anything you like.
17+
18+
### 1. node package extecutor
19+
This method is highly recommended to generate an express app.
20+
```bash
21+
npx https://www.github.com/OurCodeBase/gen3-express my-app
22+
```
23+
24+
### 2. node package manager
25+
Generation of an express app is not recommended through npm.
26+
```bash
27+
npm install -gen3 https://www.github.com/OurCodeBase/gen3-express.git
28+
```
29+
```bash
30+
gen3-express my-app
31+
```
32+
33+
## Documentation
34+
To install all dev dependencies goto the folder and hit `npm install` command.
35+
```bash
36+
cd my-app
37+
npm install
38+
```
39+
To start a dev server to preview page use `server` word.
40+
- Keep in mind that
41+
- The below command does not include EJS live reloading.
42+
43+
```bash
44+
npm run server
45+
```
46+
To start a dev server to live preview EJS page use `sync` word.
47+
```bash
48+
npm run sync
49+
```
50+
If you want to run all these servers together then you should to use this below command, this command will provide you hot reloadings in every place.
51+
```bash
52+
npm run server & npm run sync
53+
```
54+
55+
## File Cases
56+
To know about the product or project structure read about files included in this code block.
57+
58+
```bash
59+
.
60+
├── app.js # this core file handles express functions and server.
61+
├── package.json # package file handles dependencies, and details about the product.
62+
├── public # this folder contains public data like fonts, css and multimedia.
63+
│   ├── fonts
64+
│   │   └── sans.woff
65+
│   └── style.css
66+
├── sync.js # this file is needed to configure hot reloadings in ejs and static files.
67+
├── utils
68+
│   └── nets.js # this file provides functions to display available ip addresses on your network.
69+
└── views # this folder contains ejs or html files to render contents.
70+
└── home.ejs # this file is the landing page of the product.
71+
```
72+
73+
## Roadmap
74+
75+
- Custom name in `package.json` file ✅
76+
- Excellent terminal user interface ✅
77+
- Prompt `package.json` file's details from user. ⏩
78+
- Post this project to npmjs website. ⏩
79+
- Custom local template feature ⏩
80+
81+
## Authors
82+
- [@OurCodeBase](https://www.github.com/OurCodeBase)
83+
84+
## Contributing
85+
Contributions are always welcome!

docs/index.md

+17-89
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,25 @@
11
---
22
layout: home
3+
34
hero:
45
name: Gen3 Express
5-
text: A gen3 tool to generate get started express app.
6+
text: A gen3 tool to generate express app boilerplate.
7+
image:
8+
src: /icons/logo.blue.png
9+
alt: Gen3 Express
610
tagline: A free, unofficial, open-source and stable tool to generate minimal express app.
11+
actions:
12+
- theme: brand
13+
text: Get Started
14+
link: /documentation
15+
- theme: alt
16+
text: View on GitHub
17+
link: https://github.com/OurCodeBase/gen3-express
718

819
features:
9-
- icon: 💫
10-
title: Minimal and Useful
11-
details: Provides you hot reloading like more features in a very minimal express app.
20+
- icon:
21+
title: Minimal Source Code
22+
details: The source-code used in this boilerplate is super minimal.
1223
- icon: 🚀
1324
title: JS Hot Reloadings
1425
details: Provides hot reloadings when you change codes of your JS files.
@@ -19,89 +30,6 @@ features:
1930
title: Cross Platform
2031
details: You can use this tool on any platform like Linux, MacOS, Windows (WSL) and also on Android (Termux).
2132
- icon: 🥙
22-
title: NPX (no need to install extra stuff)
33+
title: NPX Usable
2334
details: You don't neet to install a separate tool to generate express apps. You can just simply use npx to fetch files and dependencies temporarily.
24-
---
25-
26-
## Changelogs <Badge type="tip" text="1.0.1" />
27-
28-
> [!CAUTION]
29-
> nets module has been shifted from `/nets.js` to the utils folder `/utils/nets.js`.
30-
> docs have also been updated.
31-
32-
## Acknowledgements
33-
You need to know atleast basics about these things.
34-
- [NodeJS](https://nodejs.org/docs/latest/api/)
35-
- [ExpressJS](https://expressjs.com/en/5x/api.html)
36-
- [Embedded JS](https://ejs.co/)
37-
38-
## Installation
39-
You can install and generate an express app using this tool in two approaches. Here I'm generating an app with name `my-app`, you can name to it anything you like.
40-
41-
### 1. node package extecutor
42-
This method is highly recommended to generate an express app.
43-
```bash
44-
npx https://www.github.com/OurCodeBase/gen3-express my-app
45-
```
46-
47-
48-
### 2. node package manager
49-
Generation of an express app is not recommended through npm.
50-
```bash
51-
npm install -gen3 https://www.github.com/OurCodeBase/gen3-express.git
52-
```
53-
```bash
54-
gen3-express my-app
55-
```
56-
57-
## Documentation
58-
To install all dev dependencies goto the folder and hit `npm install` command.
59-
```bash
60-
cd my-app
61-
npm install
62-
```
63-
To start a dev server to preview page use `server` word.
64-
> [!NOTE]
65-
> This does not include EJS and static files live (hot) reloading.
66-
```bash
67-
npm run server
68-
```
69-
To start a dev server to live preview EJS page use `sync` word.
70-
```bash
71-
npm run sync
72-
```
73-
If you want to run all these servers together then you should to use this below command, this command will provide you hot reloadings in every place.
74-
```bash
75-
npm run server & npm run sync
76-
```
77-
78-
## File Cases
79-
To know about the product or project structure read about files included in this code block.
80-
81-
```bash
82-
.
83-
├── app.js # this core file handles express functions and server.
84-
├── package.json # package file handles dependencies, and details about the product.
85-
├── public # this folder contains public data like fonts, css and multimedia.
86-
│   ├── fonts
87-
│   │   └── sans.woff
88-
│   └── style.css
89-
├── sync.js # this file is needed to configure hot reloadings in ejs and static files.
90-
├── utils
91-
│   └── nets.js # this file provides functions to display available ip addresses on your network.
92-
└── views # this folder contains ejs or html files to render contents.
93-
└── home.ejs # this file is the landing page of the product.
94-
```
95-
96-
## Milestone
97-
98-
- Custom name in `package.json` file
99-
- Excellent terminal user interface
100-
- Prompt `package.json` file's details from user.
101-
- Post this project to npmjs website.
102-
103-
## Authors
104-
- [@OurCodeBase](https://www.github.com/OurCodeBase)
105-
106-
## Contributing
107-
Contributions are always welcome!
35+
---

docs/public/icons/logo.blue.png

13.7 KB
Loading

docs/public/icons/logo.skyblue.png

10.9 KB
Loading

readme.md

+16-13
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
1-
## Changelogs 1.0.1
1+
# Gen3 Express
2+
A gen3 tool to generate express app boilerplate.
23

3-
> [!TIP]
4-
> nets module has been shifted from `/nets.js` to the utils folder `/utils/nets.js`.
5-
> docs have also been updated.
4+
## Changelogs 1.1.0
5+
tui has been implemented to gen3-express.
6+
- used signale to implement tui.
7+
- changes many things in gen3-express file.
68

79
## Acknowledgements
810
You need to know atleast basics about these things.
@@ -19,7 +21,6 @@ This method is highly recommended to generate an express app.
1921
npx https://www.github.com/OurCodeBase/gen3-express my-app
2022
```
2123

22-
2324
### 2. node package manager
2425
Generation of an express app is not recommended through npm.
2526
```bash
@@ -36,8 +37,9 @@ cd my-app
3637
npm install
3738
```
3839
To start a dev server to preview page use `server` word.
39-
> [!NOTE]
40-
> This does not include EJS and static files live (hot) reloading.
40+
- Keep in mind that
41+
- The below command does not include EJS live reloading.
42+
4143
```bash
4244
npm run server
4345
```
@@ -68,15 +70,16 @@ To know about the product or project structure read about files included in this
6870
└── home.ejs # this file is the landing page of the product.
6971
```
7072

71-
## Milestone
73+
## Roadmap
7274

73-
- Custom name in `package.json` file
74-
- Excellent terminal user interface
75-
- Prompt `package.json` file's details from user.
76-
- Post this project to npmjs website.
75+
- Custom name in `package.json` file ✅
76+
- Excellent terminal user interface ✅
77+
- Prompt `package.json` file's details from user. ⏩
78+
- Post this project to npmjs website. ⏩
79+
- Custom local template feature ⏩
7780

7881
## Authors
7982
- [@OurCodeBase](https://www.github.com/OurCodeBase)
8083

8184
## Contributing
82-
Contributions are always welcome!
85+
Contributions are always welcome!

0 commit comments

Comments
 (0)