{"id":20972349,"url":"https://github.com/michaelchadwick/raffler","last_synced_at":"2025-05-14T11:34:09.351Z","repository":{"id":47232586,"uuid":"87864523","full_name":"michaelchadwick/raffler","owner":"michaelchadwick","description":"And the winner is...","archived":false,"fork":false,"pushed_at":"2025-01-22T18:59:16.000Z","size":2571,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-13T03:04:30.107Z","etag":null,"topics":["fun","javascript","localstorage","raffle","random","webapp"],"latest_commit_sha":null,"homepage":"https://raffler.fun","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/michaelchadwick.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-04-10T22:46:46.000Z","updated_at":"2025-01-22T18:59:20.000Z","dependencies_parsed_at":"2024-04-30T22:23:47.295Z","dependency_job_id":"82f8144d-86b4-4539-8bac-577d934b40b3","html_url":"https://github.com/michaelchadwick/raffler","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelchadwick%2Fraffler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelchadwick%2Fraffler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelchadwick%2Fraffler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelchadwick%2Fraffler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/michaelchadwick","download_url":"https://codeload.github.com/michaelchadwick/raffler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254131985,"owners_count":22020059,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["fun","javascript","localstorage","raffle","random","webapp"],"created_at":"2024-11-19T04:07:39.572Z","updated_at":"2025-05-14T11:34:08.324Z","avatar_url":"https://github.com/michaelchadwick.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Raffler\n\nAnd the winner is...\n\n## Description\n\n*Raffler* is a web app designed to help make a decision. Add your items, start the machine, and then click or tap the button to watch the countdown of your cavalcade of choices. Cycling slowly ramps down to a complete stop, and a single item is selected.\n\n### Contributing\n\nTo develop locally, a few simple steps need to be taken.\n\n* clone the project to your local computer\n`$ git clone git@github.com:michaelchadwick/raffler.git`\n* change into the new directory\n`$ cd raffler`\n* run a local http server\n`$ php -S 127.0.0.1:3000` or `$ python3 -m http.server 3000` or `$ ruby -run -e httpd . -p 3000`\n\nFinally, check out [http://localhost:3000](http://localhost:3000) in a browser for your running instance!\n\nTo stop the local instance, issue a `Ctrl-C` at the command line where it's running.\n\n### Tech Specs\n\n*Raffler* uses [localStorage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage) to keep data and options stateful, even in the event of a browser reload or crash.\n\n*Raffler* has no items to raffle by default, so click on the settings menu icon (gear in top-right) and add some to the Items Available section.\n\n### Server Options\n\nIn order to change some of *Raffler*'s options, such as adding a logo, do the following:\n\n  1. Copy and rename the `/config/raffler_config.json.dist` file to `/config/raffler_config.json`.\n  2. Update the contents of `/config/raffler_config.json` to use your values\n\n```json\n{\n  \"logoFilePath\": \"/assets/images/my-logo.png\",\n  \"logoFileLink\": \"http://ohmanwhat.omg\"\n}\n```\n\nThe options that can be changed are as follows:\n\n* `dataFilePath` - json file of Raffler items that will automatically be added upon load\n* `logoFilePath` - logo for your thingy that appears next to the Raffler title\n* `logoFileLink` - somewhere to go to if you click the logo\n\nAn example file has been included as `/config/raffler_data.txt`:\n\n```txt\nBavmorda, Nockmaar\nElora Danan, Tir Asleen\nMadmartigan, Crossroads\nSorsha, Nockmaar\nWillow Ufgood, Newlyn\nFin Raziel, Tir Asleen\nMeegosh, Newlyn\nBurglekutt, Newlyn\nGeneral Kael, Nockmaar\n```\n\nThe settings menu will also allow you to toggle special effects and other debug stuff like stopping and starting a raffler in-process or re-initializing all data.\n\n#### Third-Party Help\n\n* [JS File Saving](https://github.com/eligrey/FileSaver.js) for exporting results to text\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelchadwick%2Fraffler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichaelchadwick%2Fraffler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelchadwick%2Fraffler/lists"}