Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
Personal project README template

Project Name & Pitch



An application used to filter data form Twitter based on user preference, built with React, Redux, JavaScript, and CSS.

Project Status

(only necessary if incomplete)


This project is currently in development. Users can filter tweets by username and keyword and see visual data representation. Functionality to sort by additional parameters is in progress.

Project Screen Shot(s)




Installation and Setup Instructions


Clone down this repository. You will need node and npm installed globally on your machine.


npm install

To Run Test Suite:

npm test

To Start Server:

npm start

To Visit App:



  • What was the context for this project? (ie: was this a side project? was this for Turing? was this for an experiment?)
  • What did you set out to build?
  • Why was this project challenging and therefore a really good learning experience?
  • What were some unexpected obstacles?
  • What tools did you use to implement this project?
    • This might seem obvious because you are IN this codebase, but to all other humans now is the time to talk about why you chose webpack instead of create react app, or D3, or vanilla JS instead of a framework etc. Brag about your choices and justify them here.


This was a 3 week long project built during my third module at Turing School of Software and Design. Project goals included using technologies learned up until this point and familiarizing myself with documentation for new features.

Originally I wanted to build an application that allowed users to pull data from the Twitter API based on what they were interested in, such as 'most tagged users'. I started this process by using the create-react-app boilerplate, then adding react-router-4.0 and redux.

One of the main challenges I ran into was Authentication. This lead me to spend a few days on a research spike into OAuth, Auth0, and two-factor authentication using Firebase or other third parties. Due to project time constraints, I had to table authentication and focus more on data visualization from parts of the API that weren't restricted to authenticated users.

At the end of the day, the technologies implemented in this project are React, React-Router 4.0, Redux, LoDash, D3, and a significant amount of VanillaJS, JSX, and CSS. I chose to use the create-react-app boilerplate to minimize initial setup and invest more time in diving into weird technological rabbit holes. In the next iteration I plan on handrolling a webpack.config.js file to more fully understand the build process.


This comment has been minimized.

Copy link

@remyguts remyguts commented Apr 23, 2020

I just googled example of good react project readme format haphazardly and this came up. This is great form, thank you!


This comment has been minimized.

Copy link

@nathanielshuster nathanielshuster commented Jun 9, 2020

I also googled "README template" and this was one of the first results. Nice work! I will definitely be implementing this into my projects. Thanks!


This comment has been minimized.

Copy link

@chineduknight chineduknight commented Oct 15, 2020

very nice looking to start creating proper read to my projects, not just the default stuff


This comment has been minimized.

Copy link

@in43sh in43sh commented Jan 15, 2021

Nice job! Thanks a lot.


This comment has been minimized.

Copy link

@KristinHuangg KristinHuangg commented Feb 6, 2021

Thank you! Very helpful and simple


This comment has been minimized.

Copy link

@RezaMaz RezaMaz commented Feb 22, 2021

Thanks a bunch, absolutely helpful.


This comment has been minimized.

Copy link

@ZaidKhan144 ZaidKhan144 commented Feb 25, 2021

This is God's work. Thank you for this, Brenna 🥂

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment