Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/drj17/Annotator

Genius clone using a rails backend and react frontend
https://github.com/drj17/Annotator

Last synced: about 1 month ago
JSON representation

Genius clone using a rails backend and react frontend

Awesome Lists containing this project

README 

        
# Annotator



[Annotator Live Demo](http://annotator.me)



Annotator is a full-stack web application inspired by Genius. It allows

users to add annotations to lyrics and view other users explanations.



Annotator is built with a Ruby on Rails backend, which utilizes a PostgreSQL

database, and uses React.js with a Redux framework on the frontend.



## Features & Implementation



### Songs



Songs are stored in the database with columns for `id`, `lyrics`, `artist`

and `author_id`.  Any user may view the song lyrics, but to create or delete a song,

users must be signed-in.  Users may only delete songs that they have personally added

to Annotator.  Songs are shown on the homepage, with the top three songs having

a greater presence.



#### Viewing Songs



![index page](http://i.imgur.com/8H1SCfA.png)

![song show](http://i.imgur.com/qWB6qsh.jpg)



Users can view song lyrics either by clicking the song on the homepage,

or utilizing the search feature in the upper-left-hand corner of the page.



![search](https://media.giphy.com/media/l0Iyi9zhbHZs5SyDC/giphy.gif)



#### Adding Songs



Users can add songs by clicking the "New Song" button at the top of the page,

below the logo.  Songs require a title, an artist, and lyrics. Optionally,

users can upload album artwork for song that will be saved to Amazon Web Services.



### Annotations



Annotations are stored in the database with columns for `id`, `song_id`, `author_id`,

`score`, `start_index`, and `end_index`.  Any user may view annotations but to create,

edit, or delete annotations the user must be signed in.



#### Viewing Annotations



Lyrics that have associated annotations will show up with a grey highlighting.

Users can click on these lyrics to reveal an annotation on the right hand side of the page.



![view annotation](https://media.giphy.com/media/3ohzdYc0LXLWc8Er3q/giphy.gif)



Users can vote on annotations using the thumbs-up or thumbs-down icons.  Users can also

comment on annotations using the text-field below the annotation.  If the current user

created the annotation, there will be options to edit or delete the annotation.



#### Creating Annotations



Users can create annotations by selecting text that does not already include

an annotation.  This will prompt the user to start creating an annotation if

they are signed-in, otherwise, it will first prompt the user to login.



![create annotation](https://media.giphy.com/media/l0IxZDgreuGPbdq4U/giphy.gif)



#### Comments



Comments are stored in the database with columns for `id`, `commentable_id`,

`commentable_type`, and `author_id`.



### Viewing Comments

Both songs and annotations have comment sections, where users can view the

messages let by others, newest first.



### Creating Comments

Both songs and annotations have a text field for users to add their comments.

On submission the comment will automatically be placed at the top of the comment

list



![comments](http://i.imgur.com/OspJwTZ.png)



## Future Directions for the Project



In addition to Annotators current features, there are more features in the works, including:



### User Profiles



Users will have profiles pages, where they can upload a profile picture and keep track of

the songs and annotations they have submitted. Users will also have a score based on

the total number of votes for their annotations



### Song Sorting



Genius sorts the songs on their homepage by the number of view over the last 24 hours.  The feature

ensures a dynamic home page, and I plan on implementing it.