Mailspring/README.md

78 lines
5.5 KiB
Markdown
Raw Normal View History

2015-10-03 02:26:56 +08:00
![N1 Logo](https://edgehill.s3.amazonaws.com/static/N1.png)
![N1 Screenshot](http://nylas.com/N1/images/1-1-initial-outlook-base.png?feb2016)
2015-10-03 02:26:56 +08:00
2016-05-10 08:10:40 +08:00
**N1 is an open-source mail client built on the modern web with [Electron](https://github.com/atom/electron), [React](https://facebook.github.io/react/), and [Flux](https://facebook.github.io/flux/).** It is designed to be extensible, so it's easy to create new experiences and workflows around email. N1 is built on the Nylas Sync Engine, which is also [open-source free software](https://github.com/nylas/sync-engine).
2015-10-03 02:26:56 +08:00
[![Build Status](https://travis-ci.org/nylas/N1.svg?branch=master)](https://travis-ci.org/nylas/N1)
[![Slack Invite Button](http://slack-invite.nylas.com/badge.svg)](http://slack-invite.nylas.com)
2016-02-17 12:24:17 +08:00
[![GitHub issues On Deck](https://badge.waffle.io/nylas/N1.png?label=on deck&title=On Deck)](https://waffle.io/nylas/N1)
#### Want help build the future of email? [Nylas is hiring](https://jobs.lever.co/nylas)!
2016-03-14 08:03:33 +08:00
2015-10-05 16:47:38 +08:00
# Download N1
2015-10-03 02:26:56 +08:00
You can download compiled versions of N1 for Windows, Mac OS X, and Linux (.deb) from [https://nylas.com/N1](https://nylas.com/N1). You can also build and run N1 on Fedora. A Fedora distribution is coming soon! On Arch Linux, you can install **[n1](https://aur.archlinux.org/packages/n1/)** or **[n1-git](https://aur.archlinux.org/packages/n1-git/)** from the aur.
2015-10-03 02:26:56 +08:00
2015-10-05 16:47:38 +08:00
# Build A Plugin
2015-10-03 02:26:56 +08:00
2016-05-10 08:10:40 +08:00
Plugins lie at the heart of N1 and give it its powerful features. Building your own plugins allows you to integrate the app with other tools, experiment with new workflows, and more. Follow the [Getting Started guide](http://nylas.com/N1/getting-started/) to write your first plugin in five minutes. To create your own theme, go to our [Theme Starter guide](http://github.com/nylas/N1-theme-starter).
2015-10-03 02:26:56 +08:00
2015-10-03 04:04:31 +08:00
If you would like to run the N1 source and contribute, check out our [contributing
2015-12-15 04:24:13 +08:00
guide](https://github.com/nylas/N1/blob/master/CONTRIBUTING.md).
2015-10-03 09:52:34 +08:00
2016-01-08 02:14:12 +08:00
# Plugin List
2016-01-08 02:12:25 +08:00
We're working on building a plugin index that makes it super easy to add them to N1. For now, check out the list below! (Feel free to submit a PR if you build a plugin and want it featured here.)
#### Bundled Themes
- [Dark](https://github.com/nylas/N1/tree/master/internal_packages/ui-dark)
- [Darkside](https://github.com/nylas/N1/tree/master/internal_packages/ui-darkside) (designed by [Jamie Wilson](https://github.com/jamiewilson))
- [Taiga](https://github.com/nylas/N1/tree/master/internal_packages/ui-taiga) (designed by [Noah Buscher](https://github.com/noahbuscher))
- [Ubuntu](https://github.com/nylas/N1/tree/master/internal_packages/ui-ubuntu) (designed by [Ahmed Elhanafy](https://github.com/ahmedlhanafy))
- [Less Is More](https://github.com/nylas/N1/tree/master/internal_packages/ui-less-is-more) (designed by [Alexander Adkins](https://github.com/P0WW0W))
#### Community Themes
[Create your own theme!](http://github.com/nylas/N1-theme-starter)
2016-03-29 02:22:50 +08:00
- [Arc Dark](https://github.com/varlesh/Nylas-Arc-Dark-Theme)
2016-01-19 02:32:43 +08:00
- [Predawn](https://github.com/adambmedia/N1-Predawn)
- [ElementaryOS](https://github.com/edipox/elementary-nylas)
2016-05-10 08:10:40 +08:00
- [Ido](https://github.com/edipox/n1-ido)—Polymail-inspired theme
2016-01-22 02:57:27 +08:00
- [Solarized Dark](https://github.com/NSHenry/N1-Solarized-Dark)
2016-01-25 09:38:50 +08:00
- [Berend](https://github.com/Frique/N1-Berend)
2016-01-29 05:23:10 +08:00
- [LevelUp](https://github.com/stolinski/level-up-nylas-n1-theme)
2016-02-25 11:04:51 +08:00
- [Sunrise](https://github.com/jackiehluo/n1-sunrise)
2016-03-08 01:24:21 +08:00
- [ToogaBooga](https://github.com/brycedorn/N1-ToogaBooga)
2016-03-09 07:51:11 +08:00
- [Material](https://github.com/jackiehluo/n1-material)
2016-03-20 04:35:10 +08:00
- [Monokai](https://github.com/jamiehenson/n1-monokai)
2016-05-10 08:10:40 +08:00
- [Agapanthus](https://github.com/taniadaniela/n1-agapanthus)—Inbox-inspired theme
- [Stripe](https://github.com/oeaeee/n1-stripe)
2016-03-05 08:59:02 +08:00
#### Bundled Plugins
Great starting points for creating your own plugins!
2016-05-10 08:10:40 +08:00
- [Translate](https://github.com/nylas/N1/tree/master/internal_packages/composer-translate)—Works with 10 languages
- [Scheduler](https://github.com/nylas/N1/tree/master/internal_packages/composer-scheduler)—Show your availability to schedule a meeting with someone
- [Quick Replies](https://github.com/nylas/N1/tree/master/internal_packages/composer-templates)—Send emails faster with templates
- [Emoji Keyboard](https://github.com/nylas/N1/tree/master/internal_packages/composer-emoji)—Insert emoji by typing a colon (:) followed by the name of an emoji symbol
- [GitHub Sidebar Info](https://github.com/nylas/N1/tree/master/internal_packages/github-contact-card)
- [View on GitHub](https://github.com/nylas/N1/tree/master/internal_packages/message-view-on-github)
- [Personal Level Indicators](https://github.com/nylas/N1/tree/master/internal_packages/personal-level-indicators)
- [Phishing Detection](https://github.com/nylas/N1/tree/master/internal_packages/phishing-detection)
#### Community Plugins
2016-05-10 08:10:40 +08:00
- [Jiffy](http://noahbuscher.github.io/N1-Jiffy/)—Insert animated GIFs
- [Weather](https://github.com/jackiehluo/n1-weather)
- [Todoist](https://github.com/anopensourceguy/TodoistN1)
- [Unsubscribe](https://github.com/colinking/n1-unsubscribe)
2016-01-08 02:12:25 +08:00
- [Squirt Speed Reader](https://github.com/HarleyKwyn/squirt-reader-N1-plugin/)
- In Development: [Cypher](https://github.com/mbilker/cypher) (PGP Encryption)
2016-01-08 02:12:25 +08:00
# Running Locally
2016-05-10 08:10:40 +08:00
By default, the N1 source points to our hosted version of the Nylas Sync Engine—however, the Sync Engine is open source, and you can [run it yourself](https://github.com/nylas/N1/blob/master/CONFIGURATION.md).
2016-01-08 02:12:25 +08:00
# Feature Requests / Plugin Ideas
2016-05-10 08:10:40 +08:00
Have an idea for a package or a feature you'd love to see in N1? Check out our
[public Trello board](https://trello.com/b/hxsqB6vx/n1-open-source-roadmap)
to contribute your thoughts and vote on existing ideas.