Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/joshwcomeau/tello

🐣 A simple and delightful way to track and manage TV shows.
https://github.com/joshwcomeau/tello

nodejs react reactjs redux side-project

Last synced: 8 days ago
JSON representation

🐣 A simple and delightful way to track and manage TV shows.

Awesome Lists containing this project

README 

        


A simple and delightful way to track and manage TV shows.



![Product screenshots](https://github.com/joshwcomeau/Tello/blob/master/readme-screenshots.jpg)



**It's live! Check it out: https://tello.tv**



----



### Motivation and Purpose

I created Tello because I was sick of hunting for TV shows. I wanted a tool that would show me which of my favourite shows had new episodes.



There are a lot of things Tello **doesn't** do. It doesn't tell you how to _find_ the TV show, nor whether it's available on Netflix or Hulu. It doesn't recommend similar shows you may enjoy. It doesn't tell you what your friends are watching, or offer social integrations so you can discuss what you're watching.



This started as a simple limitation of resources: Tello is an evenings-and-weekends side project, and so the scope had to be quite narrow.



Ultimately, though, I feel like that limitation is a feature. The core competency is all about helping you figure out, when you sit down on the couch after work, what's next in your backlog. I think it succeeds quite well at this :)



### Technical Info and Cool React Patterns



Tello uses React/Redux on the front-end, and Node/Express on the back-end, persisting data in MongoDB.



It's a single-page app, and the back-end is really just a thin layer around the database, with authentication. 90% of the logic lives on the client.



I experimented quite a bit with different React patterns in this project, and some of them are pretty neat! Some of the highlights:



##### Dynamic and Responsive Routing

Because of React Router 4's dynamic routes, you can do neat things, like make responsive routes. This means that routes update when the window size changes. See:

  - A [MediaQuery](https://github.com/joshwcomeau/Tello/blob/master/src/components/MediaQuery/MediaQuery.js) helper, using function-as-children, and

  - The [AppRoutes](https://github.com/joshwcomeau/Tello/blob/master/src/components/AppRoutes/AppRoutes.js) that use the prop to render routes accordingly.



Also, dynamic routes allow for this neat abstraction to create an [AuthenticatedRoute](https://github.com/joshwcomeau/Tello/blob/master/src/components/AuthenticatedRoute/AuthenticatedRoute.js) component



##### Particle Animations

The [logged-out homepage](https://tello.tv) has floating, self-drawing particles. This is a combination of:

  - [Particle](https://github.com/joshwcomeau/Tello/blob/master/src/components/Particle/Particle.js) (for the SVG drawing), and

  - [Drift](https://github.com/joshwcomeau/Tello/blob/master/src/components/Drift/Drift.js) (for the floating).



##### Behavior Components

I've been a fan of abstracting behavior into components. Here are a couple examples:

  - Dead-simple [Hover](https://github.com/joshwcomeau/Tello/blob/master/src/components/Hover/Hover.js) component using children-as-function

  - [HideOn](https://github.com/joshwcomeau/Tello/blob/master/src/components/HideOn/HideOn.js) selectively renders based on a device type.



##### Scrolling

React components can manage all kinds of window-level stuff, like scrolling:

  - [ScrollDisabler](https://github.com/joshwcomeau/Tello/blob/master/src/components/ScrollDisabler/ScrollDisabler.js) is a behavioral component which removes the ability to scroll. Useful for when modals are open, to prevent background scrolling.

  - [Scrollbars](https://github.com/joshwcomeau/Tello/blob/master/src/components/Scrollbars/Scrollbars.js) styles the main body scrollbars. This is how Tello has the neon pink scrollbars on Webkit browsers!



#### Interested in hearing more about any of these patterns? I'd love to discuss / write a blog post about them, just [let me know](https://twitter.com/joshwcomeau) :)



----



### Thanks!



If you use Tello, please don't be shy; **[let me know what you think](https://twitter.com/joshwcomeau)**!