How to Build a Location-based Twitter Search App with React and Cosmic JS


In this tutorial, we are going to create an application that filters Twitter tweets by selecting a specific location on the map. We are going to use React and Cosmic JS. We will be using Cosmic JS npm package for saving and sorting the most popular searches in our application. Let's get started.

TL;DR

View the Demo

Download the GitHub repo

Prerequisites

You will be required to install Node JS and NPM before starting. Make sure you already have them.

Getting Started

Doing everything using the existing git repo

First of all, you have to be sure you have node > 8.x: As our application uses external APIs, such as Cosmic JS, Gmail API and Twitter API we have to set the environment variables for these APIs. Note you will have to create API keys in the services mentioned above to put the "KEYS" in the .env file. Here is how your .env file has to look like.

After setting up the .envfile we have to run the following commands. 

After the successful completion of the last command browser window will automatically open, and the package.json will look like this. 

Now the app has to be running on http://localhost:3000

Source code

Server.js

Now it’s time to understand how the magic works.
Let’s take a look at server.js

Nothing special in this code, unless we take a look at the line 14. Here we setup the endpoint for the Twitter API requests, and prepare the standart request body.
More about this at Twitter API Documentation

Pages/index.js

pages/index.js is our home page file, where we have our UI, and the requests to the API’s we use.

Important functions
  • onChangeLocation - calls search function when we select a location on the map
  • search - Sends request to the Twitter API and receives the tweets in the choosen location
  • componentDidMount - Loads the most popular search topics through Cosmic JS API
Lib/cosmic.js

lib/comsic.js is the file where our code of relations with Buckets has been hosted.

Important functions

  • getSearchHistory - returns the history of the searches that were done
  • addHistory - checks if we have that topic searched before, if yes we make the popularity rank of the topic higher in our db, if not we add it there with the popularity rank 0.
Lib/twitter.js

lib/twitter.js is the file where our code for Twitter API is hosted.

Important functions
  • searchTweets - sends a search request to the Twitter API

Conclusion

In this tutorial, we’ve learned how to build an app that filters twitter tweets by location using React and Cosmic JS. All the important functions and API calls that were used in the process of development are described above.


If you have any questions about the development process, feel free to contact me at drprog00@gmail.com.

Was this article helpful?

Thank you! Your input helps us improve our articles and resources. If you have any other questions or comments, please contact support.

You may also like


Now editors can use the new Unsplash Photos Extension to find and add stock photography to their media library, all from the comfort of their Bucket Dashboard without having to interface with a third-party website like Unsplash.
Cosmic JS empowers developers and content editors by giving them the tools they need to accomplish their jobs in concert with one another.
In this tutorial, Cosmic JS co-founder Tony Spiro takes you on a tour of Cosmic JS Webhooks. Learn how webhooks work, see how to easily install integrations with Slack, auto-deploy websites to Netlify, and get an intro to Cosmic JS Functions.
Build a static web page for your company or personal portfolio using the Gatsby static site generator and the Cosmic JS Content Management Platform.
In this article I’m going demonstrate how to add new form submissions to Hubspot when you Publish Objects in your Cosmic JS Bucket.
In this blog we'll quickstart a React ToDo App using the Cosmic JS CLI. This is a simple todo application that consumes the Cosmic JS API and is built using React, Redux, Node.js and Webpack.