node-gmailer

Sending of emails from your nodejs app using your gmail account.

$3

#### Installation
``
npm install node-gmailer
`

#### Config Setup
Pass in the following environment variables using a .env file

`
EMAIL_SENDER_NAME =
GMAIL_ADDRESS =
GMAIL_APP_PASSWORD =
`

#### Example .env file content
`
EMAIL_SENDER_NAME = Smith Joe
GMAIL_ADDRESS = myemail4432@gmail.com
GMAIL_APP_PASSWORD = jdcsscscs3wn
`

#### Sending Emails

Import the package into your app

Using ES5
`js
var gmail = require('node-gmailer');
`

With ES Modules
`js
import gmail from 'node-gmailer';
`

Sending example [Single Recipient]
`js
const recipient = 'brainyfarm@gmail.com';
const messageData = {
subject: 'Olawale from node-gmailer',
text: 'Hello, this is a single recipient message from node-gmailer',
html: ' Hello , this is a single recipient message from node-gmailer'
}

gmail.send(recipient, messageData)
.then(response => {
// Email was sent, take a look at 'response'
})
.catch(error => {
// Could not send email, something went wrong, check 'error'
});
`

Sending example [Multiple Recipients] with HTML support
`js
const recipients = ['brainyfarm@gmail.com', 'node-gmailer@dispostable.com'];
const messageData = {
subject: 'Olawale from node-gmailer',
text: 'Hello, this is a single recipient message from node-gmailer',
html: ' Hello , this is a single recipient message from node-gmailer'
}

gmail.send(recipients, messageData)
.then(response => {
// Email was sent, take a look at 'response'
})
.catch(error => {
// Could not send email, something went wrong, check 'error'
});
`
#### Coming soon
- Email Template Support: Generate HTML emails with support for custom values
- Queue messages to be sent at a particular time or date
- Suggest a feature or improvements

#### Get Involved
- Report a bug
- Star the repo, fork and contribute.

#### Note
Remember to securely save your app password and ignore your .env file to avoid accidental pushing to your public repository.


Find instructions on how to generate a gmail app password` here.