Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/whitep4nth3r/thingoftheday
thingoftheday is a lightweight microblogging site powered by Contentful and vanilla HTML, CSS and JavaScript.
https://github.com/whitep4nth3r/thingoftheday
css html-5 html-css-javascript javascript no-framework
Last synced: about 2 months ago
JSON representation
thingoftheday is a lightweight microblogging site powered by Contentful and vanilla HTML, CSS and JavaScript.
- Host: GitHub
- URL: https://github.com/whitep4nth3r/thingoftheday
- Owner: whitep4nth3r
- License: mit
- Created: 2021-01-18T09:45:16.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-03-21T14:00:49.000Z (over 2 years ago)
- Last Synced: 2024-06-12T02:53:02.183Z (3 months ago)
- Topics: css, html-5, html-css-javascript, javascript, no-framework
- Language: JavaScript
- Homepage: https://thingoftheday.netlify.app/
- Size: 1.21 MB
- Stars: 47
- Watchers: 4
- Forks: 42
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# thingoftheday
## A lightweight microblogging site powered by Contentful and vanilla HTML, CSS and JavaScript
[Visit thingoftheday](https://thingoftheday.xyz/)
[Visit the tutorial article](https://www.contentful.com/blog/2021/02/05/how-to-build-a-lightweight-blog/)
If you've forked the repo and set up your own thingoftheday microblog, I'd love to share it with the world! ✨ 😎
[Find me on Twitter](https://twitter.com/whitep4nth3r) and say hello! 👋🏼
## Useful links
Contentful GraphiQL Playground:
`https://graphql.contentful.com/content/v1/spaces/{YOUR_SPACE_ID}/explore?access_token={YOUR_ACCESS_TOKEN}`
---
## Want to build your own thingoftheday?
Follow this quick setup guide to get started in minutes!
We're going to make some small changes to some handy files in the `./setup` directory, and use the Contentful CLI to import the content model and example content provided into your own Contentful space.
## Step 1: Get the code
Fork this repository to your GitHub account, and clone it to your local machine using git or the GitHub CLI.
---
## Step 2: Get Contentful
Create your Contentful account.
[Sign up here.](https://www.contentful.com/sign-up/)
---
## Step 3: Get credentials
- Create a new space inside your Contentful account
- Go to Settings > General Settings and make a note of the Space ID
- Go to Settings > API keys and generate an access token for the Content Delivery API
- Add your Space ID and access token to `./setup/credentials.js`
---
## Step 4: Install the Contentful CLI
Using homebrew:
```bash
brew install contentful-cli
```
Using npm:
```bash
npm install -g contentful-cli
```
Using yarn:
```bash
yarn global add contentful-cli
```
---
## Step 5: Authenticate with the CLI
Run `contentful login` in your terminal and follow the instructions in your browser.
---
## Step 6: Run the import
Import the content model and example post to your Contentful space.
[Access the Contentful CLI docs on importing/exporting data here.](https://www.contentful.com/developers/docs/tutorials/cli/import-and-export/)
### ::TLDR
Run the following command in your terminal, ensuring you switch out SPACE_ID for your new Space ID.
```bash
cd /path/to/repo/thingoftheday/setup
contentful space import --space-id SPACE_ID --content-file contentful-export.json
```
The terminal will do some fancy things. If all looks good - refresh Contentful in your browser and you'll find the content model and example post has been imported for you! 🎉🎉🎉
---
## Step 7: Run the application
thingoftheday uses no frameworks and is powered by vanilla HTML, CSS and JavaScript!
To be able to serve the JS module to the browser, you'll need to serve the files over a local http server.
[You can do this really nicely with this http-server package.](https://www.npmjs.com/package/http-server)
Install http-server globally, and start the development server locally by running:
```bash
cd path/to/repo
npx http-server
```
## And you're done
With your http server started, your credentials file configured, and your content model imported, you'll be able to visit your very own thingoftheday microblog in your browser - all within minutes.
## BONUS CONTENT
Generate an RSS feed of the content by hitting the following url:
```bash
https://{hostname}/.netlify/functions/rss
```
[The RSS feed for thingoftheday.xyz is available here](https://thingoftheday.xyz/.netlify/functions/rss).
And remember:
## _Build stuff, learn things, love what you do_