Entry for the Festive Tech Calendar 2021 hosted by Octopus Deploy, inspired by Eric Nagakawa's tweet.
Misconceptions is a small static webpage that lets you explore some facts you might have been taught in school that were disproven afterwards. Given your year of graduation, it will show them sorted by topic, category and group.
Being fully static, the project can be deployed with Github Pages like here.
All the information comes from Wikipedia's List of Common Misconceptions. We parsed the data into a small JSON with the following model:
Entries: {
0: {
theme,
category,
subcategory,
references: [
0: {
text,
year,
html
}
],
text,
html
},
1: {...}
}
During runtime, given a year, data gets queried and transformed into a suitable format for React:
Entries: {
0: {
themeName,
categories: [
0: {
categoryName,
subcategories: [
subcategoryName,
misconceptions: [
{...},
{...}
]
]
},
1: {...}
]
},
1: {...}
}
To run this project locally make sure you have installed all of the following prerequisites on your development machine:
- Git - Download & Install Git. OSX and Linux machines typically have this already installed.
- Node.js - Download & Install Node.js and the npm package manager. If you encounter any problems, you can also use this GitHub Gist to install Node.js.
Then:
- Clone the project
git clone https://github.com/danielquinti/octo-hack-misconceptions
- Enter the directory
cd octo-hack-misconceptions
- Install dependencies
yarn
- Start the server
yarn start
Open http://localhost:3000 to view it in the browser.
The page will reload if you make edits.
You will also see any lint errors in the console.