Skip to content

Functional Operation

Jump to bottom
Ken Manheimer edited this page Jun 26, 2014 · 5 revisions

Table of Contents

Application Entry

General conduct

At any time, if the device is unable to reach the server, the server connection retry process will kick in.

On platforms that with conventional application exit (non-iOS), hitting the device back button will either ascend to a top-level activity or, if already there, exit.

Login view

This is the initial app start view, and also the one arrived at upon logout from an active session.

(If the phone is offline or the app is otherwise unable to reach the Encryptr server, it will immediately indicate that, and proceed with the server-connection retry routine (see that section, below, for details). This can happen while logged out, and even in the absence of any user interaction.)

To login to an established account, enter "Username" and "Passphrase" and tap the "Log in" button. (The passphrase will be obscured as you type it.)

  • The UI will show three sequentially pulsing-dots (a "throbber") to indicate that it's working.
If the login fails, a dialog will obscure part of the form with the legend "Authentication error", and detail indicating one of a few reasons:
  • "Account not found."
  • "Incorrect password."
  • "Must supply username and passphrase."
Tap "OK" to dismiss the dialog and return to the login view. The entered credentials will still be present, available for revision.

If the login succeeds, the app will transition to the Content List view.

Alternately, to establish a new account, tap the "Register for a new account »" link

Account Registration view

Reached via the "Register for a new account »" link on the login view, to establish a new account fill in the "Choose a Username" and "Choose a Passphrase", then tap "Register". (In contrast to the Login view behavior, the Passphrase will remain visible, so you can confirm the accuracy of your typing.)

  • If an account with the chosen username already exists, a Signup error notification will be posted, indicating so. Tap "OK" to return to the registration view, and try again.
If the login succeeds, the app will transition to an empty Content List view.

Alternately, tap "Back to login »" to return to the Login view without registering a new account.

Server-connection retry routine

At any point, if the device is offline or the app is otherwise unable to reach the Encryptr server, the app will indicate so and systematically try to reconnect:

  • The indication will be the text "Your device isn't connected" in a red rectangle at the bottom of the screen
  • The red box will soon change to a yellow box, with a spinning half-circle on the right
  • And then a countdown in the yellow box, with the text "Connecting in #s" | "Reconnect" | and the spinner
  • The countdown will be longer on successive retries,
  • and continue until the connection succeeds or the app is exited.

(Logged-in) Session activities

Logged-in session Activities views share some common features, arranged within a black stripe across the top:

  • On the left, a session activity button, which at any moment is either a vertical ellipsis or a leftwards-pointing "return" arrow
  • A title in the middle, which varies depending on the view context.
  • An area on the right for operation icons specific to the current view context.
If the app is suspended for more than a minute, due either to switching away from the app, or device sleep, then you will be required to log in, again, to return to their content. If you resume the app before a minute elapses then you can continue from where you were.

Content List view

Upon log you arrive at the Content List view, and you return here from viewing or editing an item's details.

The menu bar for this view includes:

  • The session activity button in the top left is a vertical ellipsis for session options. Tapping the ellipsis brings up a menu with:
    • "About Encryptr" - tapping it pops up a notification that indicates the application's version, and that of the underlying Crypton library
    • "Log out", to relinquish the session's account authorization and return to the Login view.
  • The middle title is "Encryptr"
  • The right-hand side context-specific buttons includes a plus sign, by which you select a content type to add.
Your content is listed in the area below the black menu bar.

If there are no stored items, then the content area will be empty except for faded text indicating that there are not yet any entries.

If there are stored items, they will be listed, one per line, with the item name in regular type and the item type below it, in a smaller font. Successive items have a thin black dividing line between them.

If there are more items than fit in a single screen, you can drag the list to scroll and flick your finger to fling it.

Tap an item to see enter the Content Item Detail view, where you can see its details and have the option to edit or delete it.

Tap the plus icon in the upper right to open a menu where you select an item type to add. See the Content Item Addition view for details on adding on the adding process.

Content Item Detail view

You get here by tapping on a content item in the Content List view.

The menu bar for this view includes:

  • The top-left session activity button is a left-pointing "return" arrow, to return to the Content List view
  • The middle title is "Encryptr"
  • The right-hand side context-specific buttons includes a trash can, to delete the current content item (according to ok'ing a confirmation dialog), and a pencil icon, to edit the current item in Content Item Edit view
The item is presented, starting with the label (which is required for all items), followed by the field name and then the field values, with the name in a smaller, gray-faded font. Neither the field names nor values of fields with empty values are included.

Long-pressing a content item field, except for the label, copies the field's value to the device clipboard. A transient notification will briefly appear, indicating that the copy has happened. This is a handy way to copy, eg, usernames and passwords for pasting into web and application login forms.

  • To edit the item, tap the pencil icon in the upper right.
  • To delete the item, tap the garbage can icon, also in the upper right.
  • To return to the Content List view, tap the leftward-pointing arrow in the upper left.

Content Item Addition view

  • Credit Card
    • Fields: Label*, Type, Name on card, Card Number, CW, Expiry
  • General
    • Fields: Label*, Text
  • Password
    • Fields: Label*, Username, Password, Site URL
Only fields marked with an '*' asterisk are required.

Content Item Edit view

Clone this wiki locally