https://github.com/nathsimpson/isobel
A beginner-friendly node.js framework for fetching data from various sources to display in your own apps and websites.
https://github.com/nathsimpson/isobel
Last synced: 27 days ago
JSON representation
A beginner-friendly node.js framework for fetching data from various sources to display in your own apps and websites.
- Host: GitHub
- URL: https://github.com/nathsimpson/isobel
- Owner: nathsimpson
- Created: 2018-09-30T13:47:01.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-04-29T12:41:06.000Z (about 3 years ago)
- Last Synced: 2025-04-10T22:44:18.735Z (about 1 year ago)
- Language: JavaScript
- Homepage: https://isobeljs.com
- Size: 758 KB
- Stars: 12
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-github-projects - isobel - A beginner-friendly node.js framework for fetching data from various sources to display in your own apps and websites. ⭐12 `JavaScript` (📦 Legacy & Inactive Projects)
README
# ISOBEL 🐶
Welcome!
Isobel is a beginner friendly NodeJS framework for fetching data from your social profiles and other sources, for display in your own apps and websites. Isobel periodically fetches data from the services that you teach her, so the data is always there when you need it.
A great example is Twitter, which gets the latest posts from your Twitter feed. Once configured, you can access the JSON for your latest tweets at a defined URL, so you can display them on your website. That means no worrying about API rate-limiting or quotas, and no making API calls from your frontend (a big no-no).
Isobel includes a bunch of premade services, but you can also create your own.
Here is a minimum implementation of Isobel.
```javascript
const ISOBEL = require("@isobel/core");
const fileSystem = require("@isobel/file-system");
const nasa = require("@isobel/nasa");
const toMs = require("to-ms");
// initialise
const Isobel = new ISOBEL({
cache: fileSystem,
services: [
{
name: "nasa",
func: nasa.fetchPhotoOfTheDay, // gets the NASA photo of the day
interval: toMs.hours(24)
}
]
});
Isobel.start().catch(error => {
console.error("Error:", error);
process.exit(1);
});
```
Once Isobel is up and running, you can access your data in a JSON at a specific URL. e.g `localhost:4000/get/nasa`
```json
{
"url": "https://apod.nasa.gov/apod/image/1911/jC-L-TM_SunFinal5HRweb1024.jpg",
"hdurl": "https://apod.nasa.gov/apod/image/1911/jC-L-TM_SunFinal5HRweb.jpg",
"explanation": "On November 11, 2019 the Sun was mostly quiet, experiencing a minimum in its 11 year cycle of activity. In fact, the only spot v..."
}
```
Ready to go? head to the [Getting Started guide](https://isobeljs.com/guides-getting-started) to...well...get started!
## Supported services
Isobel supports many services out of the box, here is the full list
### Dribbble
Retrieves your latest shots from Dribbble
### GitHub
Retrives profile information from GitHub
### NASA
Retrives the NASA photo of the day. Treat this one as an example for you to create your own services!
### Twitter
Retrives your latest tweets!
### YouTube
Retrives information about your YouTube Channel
## Supported caching strategies
Isobel currently supports three caching strategies, with more on the way!
- local file system
- Dropbox
- Amazon S3 Buckets
## Acknowledgements
Isobel is created by [Nathan Simpson](https://nathansimpson.design). Thank you to Thomas Walker for your inspiration, support and friendship.