-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- docs are updated - changelogs are updated - version has been updated - added readme file to display on npmjs site
- Loading branch information
1 parent
bea7747
commit bb8fd0a
Showing
6 changed files
with
101 additions
and
16 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,5 +1,4 @@ | ||
/README.md | ||
/docs | ||
/.github | ||
/docs/.vitepress | ||
/package-lock.json | ||
/docs/.vitepress/dist |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,80 @@ | ||
# Gen3 Express | ||
A gen3 tool to generate express app boilerplate. | ||
|
||
## Acknowledgements | ||
You need to know atleast basics about these things. | ||
- [NodeJS](https://nodejs.org/docs/latest/api/) | ||
- [ExpressJS](https://expressjs.com/en/5x/api.html) | ||
- [Embedded JS](https://ejs.co/) | ||
|
||
## Installation | ||
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. | ||
|
||
### 1. node package extecutor | ||
This method is highly recommended to generate an express app. | ||
```bash | ||
npx gen3-express my-app | ||
``` | ||
|
||
### 2. node package manager | ||
Generation of an express app is not recommended through npm. | ||
```bash | ||
npm install -g gen3-express | ||
``` | ||
```bash | ||
gen3-express my-app | ||
``` | ||
|
||
## Documentation | ||
To install all dev dependencies goto the folder and hit `npm install` command. | ||
```bash | ||
cd my-app | ||
npm install | ||
``` | ||
To start a dev server to preview page use `server` word. | ||
- Keep in mind that | ||
- The below command does not include EJS live reloading. | ||
|
||
```bash | ||
npm run server | ||
``` | ||
To start a dev server to live preview EJS page use `sync` word. | ||
```bash | ||
npm run sync | ||
``` | ||
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. | ||
```bash | ||
npm run server & npm run sync | ||
``` | ||
|
||
## File Cases | ||
To know about the product or project structure read about files included in this code block. | ||
|
||
```bash | ||
. | ||
├── app.js # this core file handles express functions and server. | ||
├── package.json # package file handles dependencies, and details about the product. | ||
├── public # this folder contains public data like fonts, css and multimedia. | ||
│ ├── fonts | ||
│ │ └── sans.woff | ||
│ └── style.css | ||
├── sync.js # this file is needed to configure hot reloadings in ejs and static files. | ||
├── utils | ||
│ └── nets.js # this file provides functions to display available ip addresses on your network. | ||
└── views # this folder contains ejs or html files to render contents. | ||
└── home.ejs # this file is the landing page of the product. | ||
``` | ||
|
||
## Roadmap | ||
|
||
- Custom name in `package.json` file ✅ | ||
- Excellent terminal user interface ✅ | ||
- Prompt `package.json` file's details from user. ⏩ | ||
- Post this project to npmjs website. ✅ | ||
- Custom local template feature ⏩ | ||
|
||
## Authors | ||
- [@OurCodeBase](https://www.github.com/OurCodeBase) | ||
|
||
## Contributing | ||
Contributions are always welcome! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,11 +1,17 @@ | ||
# Changelogs | ||
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. | ||
|
||
## Changelogs 1.1.1 | ||
generator published at npmjs. | ||
- docs updated | ||
- package updated | ||
- npm ignore file updated | ||
|
||
## Changelogs 1.1.0 | ||
tui has been implemented to gen3-express. | ||
- used signale to implement tui. | ||
- changes many things in gen3-express file. | ||
|
||
## Changelogs 1.0.1 | ||
- nets module has been shifted from `/nets.js` to the utils folder `/utils/nets.js`. | ||
- docs have also been updated. | ||
- docs have also been updated. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters