Need help with twitter-interaction-circles?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

153 Stars 45 Forks MIT License 7 Commits 4 Opened issues


A guide project on how to make interaction circles for Twitter

Services available


Need anything else?

Contributors list

# 127,425
5 commits


Twitter Interaction Circle

Originally from Twopcharts it has been making the round in the dev community. I believe this is a great opportunity for a project to learn from. The concept is easy and straightforward but the realization encompasses a lot of concepts.

You can read more about the realization of this project on the HackerTyper Blog.


shell script
git clone [email protected]:duiker101/twitter-interaction-circle.git
cd twitter-interaction-circle
yarn install

Run with

shell script
yarn build

You can also generate a text version of the image with the complete list of the presented users with the following command

shell script
yarn build --text
The output will go in
file in the root of the project


To use the project you will need Twitter API keys. You can get one on the developer portal.

As this project uses only public data, you don't need an authorization key, but you can generate a Bearer Token. This will prevent you from fetching any private data but will grant you slightly higher rate limiting.

More information about Twitter's bearer tokens can be found here

Once you have your consumer keys, rename the

and put them in there, it should look like this:

Make sure you don't have spaces.


If you wish, you can replace the first part of the main loop in the

to use the getUser() function instead of getMe(). This will allow you to generate the circles for any public Twitter user. All the API methods used take advantage only of public data.


You can try to apply the following changes to test your knowledge: - Apply a shade to each avatar based on the most common type of interaction - Fetch the circles for another user - Render a grid instead of the circles

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.