{"id":38386816,"url":"https://github.com/twitchdev/animal-facts","last_synced_at":"2026-01-17T03:43:59.823Z","repository":{"id":43586587,"uuid":"152108437","full_name":"twitchdev/animal-facts","owner":"twitchdev","description":"Extension sample with React based frontend, backend service that leverages Configuration Service","archived":false,"fork":false,"pushed_at":"2022-12-22T08:56:44.000Z","size":431,"stargazers_count":21,"open_issues_count":22,"forks_count":5,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-05-29T06:50:28.034Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/twitchdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-10-08T16:03:36.000Z","updated_at":"2023-07-21T21:49:49.000Z","dependencies_parsed_at":"2023-01-30T06:30:26.369Z","dependency_job_id":null,"html_url":"https://github.com/twitchdev/animal-facts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/twitchdev/animal-facts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twitchdev%2Fanimal-facts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twitchdev%2Fanimal-facts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twitchdev%2Fanimal-facts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twitchdev%2Fanimal-facts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/twitchdev","download_url":"https://codeload.github.com/twitchdev/animal-facts/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twitchdev%2Fanimal-facts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28493639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T02:39:23.645Z","status":"ssl_error","status_checked_at":"2026-01-17T02:34:19.649Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-17T03:43:59.760Z","updated_at":"2026-01-17T03:43:59.813Z","avatar_url":"https://github.com/twitchdev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Extensions-Animal-Facts\nA sample extension that demonstrates how to leverage the Extensions Configuration Service in tandem with an EBS. \n\n## What's in the Sample\nThe Animal Facts extension demonstrates a simple scenario of storing and retrieving extension configuration data. Specifically, the extension displays animal facts (ie. \"Cats are unable to detect sweetness in anything they taste.\") to viewers based on the animal type (cat or dog) that the broadcaster has selected when configuring the extension.\n\n\n## Requirements\n- Node.JS LTS+ with [`yarn`](https://yarnpkg.com/en/) for package management.\n- Go 1.10+ with [`dep`](https://github.com/golang/dep) for package management. \n\nYou can install `yarn` by running:\n```bash\nnpm i -g yarn\n```\n\nYou can install `dep` by running:\n```bash\nbrew install dep\n```\n\n## First time Usage\n\nThe recommended path to using this sample is with the [Developer Rig](https://dev.twitch.tv/docs/extensions/rig/).\n\nFirst, clone the repository into the folder of your choice. \n\nNext, do the following: \n\n1. Change directories to the cloned folder.\n2. ONLY IF RUNNING LOCALLY (not in the developer rig): Run `yarn install` to install all prerequisite packages needed to run the frontend. \n3. ONLY IF RUNNING LOCALLY (not in the developer rig): Run `yarn cert` to generate the needed certificates; this allows the frontend and EBS servers to be run over HTTPS.\n4. Change directories to the `/ebs` folder.\n5. Open the `.env` file and set your extension `Client ID`, `Secret`, and the `User ID` of the extension owner (likely you).\n6. Run `dep ensure` to install all prerequisite packages needed to run the EBS. \n7. Run `go build` to compile the EBS binary.\n\nYou can now start the sample from the Developer Rig. In the Project Overview, set the following fields:\n\n1. Project Name: `Animal Facts`\n2. Front-end Files Location: `path-to-clone-repository/`\n3. Front-end Host Command: `yarn start`\n4. Back-end Run Command: `ebs`\n5. Project Folder: `path-to-clone-repository/ebs`\n\n## File Structure\n\nThe file structure in the template is laid out with the following: \n\n### bin\n\nThe `/bin` folder holds the cert generation script. \n\n### conf \n\nThe `/conf` folder holds the generated certs after the cert generation script runs. \n\n### dist\n\n`/dist` holds the final JS files after building. \n\n### public\n\n`/public` houses the static HTML files used for your code's entrypoint. \n\n### src\n\nThis folder houses all source code and relevant files (such as images). Each React class/component is given a folder to house all associated files (such as associated CSS).\n\nBelow this folder, the structure is much simpler.\n\nThis would be: \n\n`\ncomponents\n-\\App\n--\\App.js\n--\\App.test.js\n--\\App.css\n-\\Authentication\n--\\Authentication.js\n...\n`\n\n### ebs\n\nThis folder houses all of the source code for the sample backend. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwitchdev%2Fanimal-facts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftwitchdev%2Fanimal-facts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwitchdev%2Fanimal-facts/lists"}