URLockBox

URLockbox is a small application for tossing various forms of inspiration for later review. It's not unlike Delicious or Pinboard. It is the spiritual successor of Ideabo.

The idea behind is to allow authenticated users to login, write down their titles and links, so it can be used in the future as a reference.

Section 1 - Sign Up, Sign In, and Sign Out

1. Sign Up

   As an unauthenticated user, if I click "Sign Up", I should be taken to a user form where I can enter an email address, a password, and a password confirmation.

   • I cannot sign up with an email address that has already been used.
   • Password and confirmation must match.
   • If criteria is not met the user should be given a message to reflect the reason they could not sign up.

   Upon submitting this information, I should be logged in via a session cookie and redirected to the "Links Index" page.

2. Sign In

   As an registered user when I attempt to sign in, I receive a flash message reflect a successful, or unsuccessful log in attempt.

3. Sign Out

   As an authenticated user viewing the index page, I should see a link to "Sign Out" and not see a link to "Sign In". This should redirect me back to the page that prompts me to "Log In or Sign Up".

Section 2 - Submitting links

1. Submitting Links

As an authenticated user viewing the main page (links#index), I should see a simple form to submit a link.

The Link model should include:

1. A valid URL location for the link.

2. A Title for the link.

3. Additionally, all links have a read status that is either true or false. This status will default to false everytime a new record is created.

4. Submitting an invalid link should result in an error message being displayed that indicated why the user was not able to add the link (I have used flash messages to handle this piece of the application).

5. Viewing Links

6. Once a link has been submitted, we should render the index page.

7. should display all of my links only.

Section 3 - Editing Links

1. Edit posted link

As an authenticated user who has added links to my URLockbox, when I view the links index:

1. Each link has an "Edit" button that either takes me to a page to edit the link.

2. I can edit the title and/or the url of the link.

3. I cannot change the url to an invalid url. Render error message in case this scenario takes place.

Section 4 - Implementing a Service

1. Hot Reads App

   I have build a second application called Hot Reads, that fulfills the following requirements.

   1. When a link in the URLockbox is marked as "read", the link's info is automatically sent to Hot Reads app.

   2. Hot Reads create a record of the "read" links.

Section 5 - Client-Side

1. Client-Side Features:

   As an authenticated user, I can do the following in the URLockbox index without reloading the page:

   1. Mark a link as read or unread
   • Next to each unread link I should see an option to "Mark as Read".
   • Clicking this should visibly change the read status to true, and the change should persist.
   • Next to each read link I should see an option to "Mark as Unread".
   • Clicking this should change the read status to false, and the change should persist.

   2. Read links will be stylistically differentiated from unread links. I have decided to strike through.

   3. Click a button or link to filter the list by "read" and "unread" status

   4. Filter the list of links by title name within the search box.

   5. In addition, we have used client-side request and a bit of JavaScript to do the following:

      1. If a visible link is in Hot Read's current top-10, mark it as "hot" (in red color)
      2. If a visible link is currently number one in the top-10, mark it as "top link" (in yellow color)

Feel free to challenge yourself and recreate the application.

Raphael Barbo