Deprecation Notice

This repo served as a quick 'n' dirty place to kick off development for a UI for CrypTag, but this code is no longer actively being developed.

If you'd like to contribute to this project, see CrypTask.

CPass UI

This is a desktop app made with electron and React.js that is designed as a simple UI wrapper that talks to a local server/API/daemon cryptagd which is provided by CrypTag.

If you're not using CrypTag to manage your passwords, you should be. Go install it. It's awesome.

Pre-requisites

Install either cpass to store passwords to a local folder, or cpass-sandstorm to store them in Sandstorm (once you install the CrypTag Sandstorm app ).

cpass

Make sure you have Go installed, then run:

$ go get github.com/elimisteve/cryptag/cmd/cpass
$ cpass

For more on getting started with cpass, including how to store and fetch passwords at the command line, see https://github.com/elimisteve/cryptag#getting-started-with-cryptpass.

cpass-sandstorm

Make sure you have Go installed, then run:

$ go get github.com/elimisteve/cryptag/cmd/cpass-sandstorm
$ cpass-sandstorm init <sandstorm_webkey>

To generate a Sandstorm webkey, install this then click the key icon near the top of your screen.

If someone else gave you the Sandstorm webkey along with the decrypt key needed to access the passwords s/he is sharing with you, also run

$ cpass-sandstorm setkey <key>

cryptagd

Install the local daemon cryptagd that CPass UI talks to:

$ go get github.com/elimisteve/cryptag/servers/cryptagd

Run it in one terminal with

$ cryptagd

meanwhile, in another terminal, run CPass UI (see next section).

Installation and Running

$ npm install

then

$ npm start

Testing

There are some placeholder tests included here that test the rendering of the individual components and the final compiled version of the app. You'll need to build the app first:

$ npm run build

If you're on Linux, instead run:

$ npm run build-linux

(TODO: automate this based on system platform detection.)

$ npm test