You can use this plugin to compose an e-mail, have the user edit the draft manually, and send it.

Note that this plugin depends on the default mail app. If you want a fallback to a third party client app like Gmail or Outlook, then check for availability, and if not available use a solution like the Social Share plugin.


ns plugin add @nativescript/email



import * as email from '@nativescript/email'

email.available().then((avail: boolean) => {
  console.log('Email available? ' + avail)


import * as email from '@nativescript/email'
import { knownFolders } from '@nativescript/core'

// let's first create a File object
const appPath = knownFolders.currentApp().path
const logoPath = appPath + '/res/nativescript-logo.png'

    subject: 'Yo',
    body: 'Hello <strong>dude</strong> :)',
    to: ['eddyverbruggen@gmail.com', 'to@person2.com'],
    cc: ['ccperson@somewhere.com'],
    bcc: ['eddy@combidesk.com', 'eddy@x-services.nl'],
    attachments: [
        fileName: 'arrow1.png',
        mimeType: 'image/png'
        fileName: 'nativescript-logo.png',
        path: logoPath,
        mimeType: 'image/png'
    () => {
      console.log('Email composer closed')
    err => {
      console.log('Error: ' + err)

Full attachment support has been added to 1.3.0 per the example above.

Since 1.4.0 the promise will be rejected in case a file can't be found.

Usage with Angular

Check out this tutorial (YouTube) to learn how to use this plugin in a NativeScript-Angular app.

Known issues

On iOS you can't use the simulator to test the plugin because of an iOS limitation. To prevent a crash this plugin returns false when available is invoked on the iOS sim.


Apache License Version 2.0