Hello everyone, welcome to the introduction post of DevSpaces. DevSpaces is my submission project for Hashnode x Netlify hackathon.
Introduction to DevSpaces
DevSpaces is an open-source twitter spaces finder app for programmers. It uses keywords like 'tech', 'programming', 'web' etc. to fetch spaces related to those keywords from Twitter API and display them on the UI.
- NextJS - for building the app
- TailwindCSS - for styling
- Google Fonts - for fonts
- React Icons - for icons
- SuperTokens - for user auth
- Netlify - for deployment
How it works
DevSpaces ask you to select one of the existing keyword cards. Currently, there are 5 keyword cards - Tech, Web, Dev, Developer, and Programming.
Once you select the keyword, the sign-in page will be open. Enter your login credentials or else sign up if are visiting for the first time.
Once signed in, you can see all the current live and scheduled spaces related to that keyword and enjoy your favorite ones.
For the first version, there are 5 keyword cards-
Once you select any one of those, you will be prompted to the sign-in page just like the image below.
Click on the Sign Up button located at the side of Not registered yet? Enter your email ID and create a password. Once signed up, you will see all the current live and scheduled spaces of the keyword which you selected before.
If the space is live you will be shown the Start Listening button in the Space card along with the number of current listeners.
If the space is scheduled, you will be shown the Set Reminder button in the Space card along with the scheduled time in ISO 8601 format.
Both Start Listening and Set Reminder buttons will lead you to the Twitter link of that particular space.
I will thank Dinesh for inspiring me to build this project. I was working on another project in January and he told me to work more on projects that help you stand out and try out something with Twitter API.
That's how this idea came to my mind. Initially, I was thinking to build a spaces finder for everyone but he helped me niche down to build only for programmers(which was a better decision.)
When I started the project, I didn't have any clear idea of what the finished app will look like. So I experimented a lot with various fonts, color palettes, and layouts and came to the current design of the project.
Now let's start the building process -
I started the project by cloning NextJS Twitter Starter kit. It's a great starter kit for building NextJS, Tailwind, and Twitter API projects.
I created a folder called component at the root of the directory and separated the entire landing page into 5 components -
If you want to dive deep into the codebase - you can look up at the GitHub repo to learn how exactly are they built. For this article, I will give you only a brief overview of how I built the project.
There are total of 5 pages for 5 keywords in the first version - tech.js, web.js, programming.js, dev.js, and developer.js. These 5 files are created inside the pages directory so that they have their independent page(NextJS rocks).
Inside each file, the Twitter API is fetched with the query of the page keyword.
You can see the
query=tech part in the endpoint variable. We have to replace tech with web, dev, developer, etc depending on the page.
The data is fetched inside the
getServerSideProps function of the NextJS and they are then mapped with the
.map array method to display that information on the UI.
Error 500 page
While building the app I noticed that most of the tech spaces are in the tech or web keyword and there are times when there is no live or scheduled space with other keywords. To tackle this issue, I created a custom
_error.js page, thanks to Chris Bongers for his blog post on creating a custom error page.
The last part of the building process was to protect the website routes from non-signed users. Thanks to SuperTokens, I build an email password authentication for my website in no time. I am soon going to write another blog post on SuperTokens and will see how to build auth in SuperTokens and NextJS.
This was my submission article for Hashnode x Netlify hackathon. I loved building this project. If you have any feedback or don't understand anything. Feel free to tell me in the comments or reach out to me on Twitter.