Nylas Mailbox (<nylas-mailbox>
) is part of the Nylas Components library that lets you build email/mailbox applications in minutes. Use Nylas Mailbox with your Nylas account or by passing in your own JSON data.
Nylas Mailbox is currently in active development. Want to contribute? Find out how!
In your JavaScript application, you can install Nylas Mailbox with:
- npm
npm i @nylas/components-mailbox
- Yarn
yarn add @nylas/components-mailbox
Alternatively, on an html page, you can load the Mailbox using a script tag:
<head>
<!-- Import the script from CDN -->
<script src="https://unpkg.com/@nylas/components-mailbox"></script>
</head>
For both installation options, in the body of your page, you can instantiate the mailbox component with <nylas-mailbox></nylas-mailbox>
.
All Nylas components have two ways of displaying data to your end-user:
If you haven't registered for a Nylas account yet, you can do so at dashboard.nylas.com. Once there, head to the Components tab and create a new Mailbox component.
You'll be guided through the component setup and be given the options to customize your mailbox component. Review the Mailbox Documentation.
During the setup process, you'll be prompted to provide a list of allowed domains. Be sure to add any domains you'll be testing your app on, including localhost
, and any staging and production URLs you might use.
Nylas Mailbox can be used as a UI on top of any threads data that you provide. Threads should follow the Nylas thread object standard.
The property to use for this is all_threads
. You can pass in a JSON array of threads.
const staticThreads = [
{
"account_id":"adsghdgajhsgdikzvz9afb",
"drafts":[],
"first_message_timestamp":1621472861,
"has_attachments":false,
"id":"daskjdkahskjdhk7md84fgk",
"labels":[{"display_name":"Inbox","id":"asdghsdfafasdfdsfcm4","name":"inbox"}],
"last_message_received_timestamp":1621472865,
"last_message_sent_timestamp":null,
"last_message_timestamp":1621472865,
"messages":[
{
"account_id":"adsghdgajhsgdikzvz9afb",
"bcc":[],
"cc":[
{"email":"[email protected]","name":"Phil Renaud"},
{"email":"[email protected]","name":"Review requested"}
],
"date":1621472861,
"files":[],
"from":[
{"email":"[email protected]","name":"Mostafa Rashed"}
],
"id":"epgdadhsgfdghasyy6h9yyle6v",
"labels":[
{"display_name":"Inbox","id":"3fhdx7ssdfsfsdfm5ecwcm4","name":"inbox"}
],
"object":"message",
"reply_to":[
{"email":"[email protected]","name":"nylas/nylas-nodejs"}
],
"snippet":"Hi, Welcome to Nylas",
"starred":false,
"subject":"Hello from Nylas",
"thread_id":"ddfgdfdgdjsgdjhas7md84fgk",
"to":[
{"email":"[email protected]","name":"nylas/nylas-nodejs"}
],
"unread":true
},
{}
],
"snippet":"Hi, Welcome to Nylas",
"starred":false,
"subject":"Hello from Nylas",
"unread":true,
"version":1
},
{
}
]
Then pass the array into your component using any JavaScript.
<nylas-mailbox all_threads={staticThreads}>
You can also use plain JavaScript as an attribute.
document.querySelector("nylas-mailbox").all_threads = staticThreads;
Nylas Mailbox allows for several properties that affect the layout and functionality of your component. You can find a complete list of properties within our Documentation for Nylas Mailbox
You can listen to certain user events from your application by adding an event listener to your component.
For example, you can listen for a threadClicked
event with the following code:
document
.querySelector("nylas-mailbox")
.addEventListener("onStarSelected", (event) => {
let { detail } = event;
console.log("star selected: ", detail);
});
A list of emitted events is available on our Documentation for Nylas Mailbox
Please refer to our Contributing Guidelines for information about how to get involved. We welcome bug reports, questions, and pull requests.
- Git clone
[email protected]:nylas/components.git
- Run
yarn install
- Run
yarn start
; your browser will loadhttp://localhost:8000
and show you a list of available running components
yarn cy:open
will launch our end-to-end tests in a browser
tests will automatically be run on push from push.yaml