To get started with ExpressWebJs, you will need to install
Node.js >= v14.15.1 and npm >= 6.0.0
Because we want it to be as easy as possible getting started with ExpressWebJs, that's while we have a command line tool to help you install ExpressWebJs.
To start your new typescript project, you can use
npx expresswebcli new command, followed by your project name and --ts or --typescript.
--typescript flag tells Expresswebjs to generate the typescript version.
npx expresswebcli new ritetech --ts or npx expresswebcli new ritetech --typescript
Or you can install it globally via npm like so:
npm install -g expresswebcli
and then run to create your new ritetech application.
expresswebcli new ritetech --ts or expresswebcli new ritetech --typescript
Make sure to add the npm system-wide node_modules/.bin directory to your $PATH to be able to access the installed binary.
Once that is done,
Once you do that, you can now install all dependencies by running npm install.
In version 2 upwards, MAKER command line interface is included in ExpressWebJs. Maker exists at the root of your application as the maker script and provides a number of helpful commands that can assist you while you build your application.
Run the following code once you have created your new application to see all maker commands.
ts-node maker -h
# Database Setup
ExpressWebJs makes interacting with SQL and NOSQL databases extremely easy across a variety of supported database.
- Amazon Redshift
- MicroSoft SQL
Befor we continue, if you've not created your .env file, quickly do that by copying example.env to .env file or you can run the following command in your terminal:
cp example.env .env
Now that our .env file is ready, the configuration for ExpressWebJs database is located in Config/database.ts configuration file. In this file, you may define all of your database connections, as well as specify which connection should be used by default. Most of the configuration options within this file are driven by the values of your application's environment variables.
# SQL Database configuration
You can easily configure your environment variables to point to your database by placing the connection values in the .env file: Let's connect to mysql database
DB_SHOULD_CONNECT = true; //should connect to database DB_CONNECTION = mysql; //database DB_HOST = localhost; //database host DB_PORT = 3306; //database port DB_USER = DB_PASSWORD = DB_DATABASE = DB_USENEWURLPARSER = true; //database username //database password //database name DB_USEUNIFIEDTOPOLOGY = true; DB_USECREATEINDEX = true;
# NOSQL Database configuration
You can configure your nosql database environment variables to point to your database by placing the connection values in the .env file: Let's connect to mongoDB
DB_SHOULD_CONNECT = true; //should connect to database DB_CONNECTION = mongoose; //database DB_HOST = localhost; //database host DB_PORT = 27017; //database port DB_USER = DB_PASSWORD = DB_DATABASE = DB_USENEWURLPARSER = true; //database username //database password //database name DB_USEUNIFIEDTOPOLOGY = true; DB_USECREATEINDEX = true;
Once that is done, you can now run your application with:
npm run dev
# Initial Configuration
ExpressWebJs configuration files are stored in the application config directory Config. Each option is documented, so feel free to look through the files and get familiar with the options available to you.
You are free to get started developing! However, you may wish to review the Config/app.ts file and its documentation. It contains several options you may wish to change according to your application.