.Env & environment.ts

Minimum configuration to get started with Nesula

NestJS

URL

Localhost

Configure NestJS for local development on localhost:

nest-api/.env.dev

# ----- APP -----
...
NES_PORT = 3009
NES_URL_APP = 'http://localhost:4200'
NES_URL_API = 'http://localhost:${NES_PORT}'

Live Domain

Configure NestJS for a live domain name pointed to the development server:

nest-api/env.dev

# ----- APP -----
...
NES_PORT = 3009
NES_URL_APP = 'https://dev.nesula.ifactory.co'
NES_URL_API = 'https://dev.nesula.ifactory.co'

Database

nest-api/env.dev

# ----- POSTGRES -----
NES_POSTGRES_HOST = "localhost"
NES_POSTGRES_PORT = 5432
NES_POSTGRES_USERNAME = "postgres"
NES_POSTGRES_PASSWORD = "your-database-password"
NES_POSTGRES_DATABASE = "nesula_dev"

Mail

Nesula requires a mail server to relay email for user verification. Add your email server details to your config:

nest-api/env.dev

# ----- MAIL -----
NES_MAIL_SEND_ENABLED = true
NES_MAIL_FROM_EMAIL = '[e-mail]'
NES_MAIL_FROM = '"Nesula Support Team" <${NES_MAIL_FROM_EMAIL}>'
NES_MAIL_HOST = 'server.nesula.com.au'
NES_MAIL_PORT = 465
NES_MAIL_SECURE = true
NES_MAIL_USERNAME = '[e-mail]'
NES_MAIL_PASSWORD = 'my-secure-mail-password'

Ensure you add your live server domain to your TXT SPF DNS record to authorise the server to send email for that domain.

Don't have a mail server?

If you have access to a cPanel server you may create a hosting account that matches your live domain. Then create an MX & TXT DNS record that authorises cPanel to send and receive email. Add the cPanel accout to your .env file.

Use one of the many third-party services that offer fake SMTP servers that facilitate routing of email for development & testing.

Third-party fake SMTP server providers:

• MailTrap: https://mailtrap.io/fake-smtp-server/
• Mailosaur: https://mailosaur.com/

Security

CORS Whitelist

Whitelist domains that are required to make API request to NestJS

# ----- SECURITY -----
NES_CORS_ORIGIN_WHITELIST = 'https://dev.nesula.com http://localhost:4200'
...

Angular

Configure Angular by adding the base URL for any API requests that the Angular app will make to the NestJS server.

angular-app/src/environments/environment.dev.ts

export const environment: EnvironmentModel = {
  ...
  apiUrl: 'https://dev.nesula.com/api',
  ...
};