pixelated / pixelated-user-agent

User facing components of Pixelated: a JavaScript single page app and a RESTful service.
GNU Affero General Public License v3.0
159 stars 72 forks source link

Pixelated User Agent

CircleCI Coverage Status Stories in Doing

The Pixelated User Agent is the email client of the Pixelated ecosystem. It is composed of two parts, a web interface written in JavaScript (FlightJS and React) and a Python API that interacts with a LEAP Provider, the email platform that Pixelated is built on.

Here's a podcast that explains the project.

Pixelated is still in early development state!

High level architecture User Agent

Installing Pixelated as a Service

To run your own instance of Pixelated, follow these instructions: https://github.com/pixelated/puppet-pixelated#manual-installation

Installing Pixelated for Development

If you want to run and test it locally, then before you have to install the following dependencies:

Option 1: Run Pixelated User Agent against an existing LEAP provider

  1. If you don't have access to an existing LEAP provider, you can create an account at Bitmask mail demo provider.

  2. Clone the Pixelated User Agent repo and start the virtual machine (downloads 600MB, you may want get a coffee or tea in the meantime):

    $ git clone https://github.com/pixelated/pixelated-user-agent.git
    $ cd pixelated-user-agent
    $ vagrant up
  3. Log into the VM:

    • You can access the guest OS shell via the command vagrant ssh run within the pixelated-user-agent folder in the host OS.
    • /vagrant in the guest OS is mapped to the pixelated-user-agent folder in the host OS. File changes on either side will reflect in the other.
    $ vagrant ssh
    $ cd /vagrant
  4. Start the pixelated user agent:

    $ pixelated-user-agent --host 0.0.0.0 --multi-user --provider=mail.bitmask.net

    You also have other ways to start the user agent. Check the "Single User Mode vs Multi User Mode" page.

  5. Go to localhost:3333 on your browser. You should see the login screen, where you can put your username and password created on step 1. Once you login, you'll see your inbox.

    First time email sync could be slow, please be patient. This could be the case if you have a lot of emails and it is the first time you setup the user agent on your machine.

Option 2: Run Pixelated User Agent against a local LEAP provider

We suggest you to use the following instructions:

Contributing

You are most welcome to contribute to the Pixelated User Agent code base. Please have a look at the contributions guide.

If you want to contribute as a designer or XD, see the issues labeled 'Needs Prototype' for some ideas of where to start!

Useful links

And much more in our wiki pages