{"id":19030643,"url":"https://github.com/hackclub/jams","last_synced_at":"2025-06-20T00:04:38.133Z","repository":{"id":186206928,"uuid":"663523166","full_name":"hackclub/jams","owner":"hackclub","description":"We're jamming!","archived":false,"fork":false,"pushed_at":"2025-06-09T15:49:16.000Z","size":4837,"stargazers_count":45,"open_issues_count":17,"forks_count":103,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-09T16:41:30.338Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://jams.hackclub.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hackclub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2023-07-07T13:45:56.000Z","updated_at":"2025-06-09T15:49:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"84dc8708-11f5-4121-9a1c-188313791920","html_url":"https://github.com/hackclub/jams","commit_stats":null,"previous_names":["hackclub/jams"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hackclub/jams","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackclub%2Fjams","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackclub%2Fjams/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackclub%2Fjams/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackclub%2Fjams/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hackclub","download_url":"https://codeload.github.com/hackclub/jams/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackclub%2Fjams/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260852095,"owners_count":23072587,"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":[],"created_at":"2024-11-08T21:18:58.151Z","updated_at":"2025-06-20T00:04:33.113Z","avatar_url":"https://github.com/hackclub.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg width=\"192\" alt=\"Hack Club logo\" src=\"https://assets.hackclub.com/flag-standalone.svg\"\u003e\u003c/p\u003e\n\u003ch1 align=\"center\"\u003e\u003ca href=\"https://jams.hackclub.com\"\u003eHack Club Jams\u003c/a\u003e\u003c/h1\u003e\n\nHack Club Jams: Collaborative coding workshops where sparks ignite, fears dissolve, and inventions come to life. We're jamming away at Hack Club here!\n\n## 🎉 Getting started\n\nHead over to [the Jams website](https://jams.hackclub.com) to get started with your first jam!\n\nIf you ever need help, the [Hack Club Slack](https://hackclub.com/slack/) is full of welcoming teens ready to help!\n\n## I want to make a jam!\n\nAwesome! Or should I say, jamtastic! Before you get started, check out the [guidelines](https://docs.google.com/document/d/1apYcjpCHrA5hJZa2-g_A8ToJeOv-2zwfRV4bg7l2G_k/edit) we have for new and incoming jams - we want to make sure that all jams are amazing and can be run smoothly in clubs, and making your jam while keeping in mind these guidelines will help us make sure that happens.\n\nOnce you've read the guidelines, you can get started by forking this repository and adding your jam to the `jams` folder.\n\n\u003cdetails\u003e\n    \u003csummary\u003eHow do I fork this repository?\u003c/summary\u003e\n\nClick on the \"Fork\" button in the top right corner of this page and follow the prompts to create your own copy of this repo.\n\nAfterwards, clone your copy:\n\n```\ngit clone https://github.com/\u003cyour username\u003e/jams\n```\n\nNow head to where the copy is on your computer and start making some changes!\n\nOnce you're done, you can make a pull request (PR) to this repository. To do that, run the following on your computer inside your jams folder:\n\n```\ngit add .\ngit commit -m \"\u003cWhat did you do?\u003e\"\ngit push\n```\n\nThis will send the changes you made to your repository. To send it to ours, go to your repository on GitHub and click on the button that says `Contribute` right above the code viewer. It will ask you to `Open a pull request` - go ahead and do that. It'll take you to a page that looks like this:\n\n![PR page](https://cloud-3d1rlweqr-hack-club-bot.vercel.app/0screenshot_2023-08-16_at_15-47-10_comparing_hackclub_main...jianmin-chen_main____hackclub_workshops.png)\n\nFill in the title, maybe add a little description, and click that big green button that says `Create pull request`! That's it! You've made a PR!\n\n\u003c/details\u003e\n\nDepending on what the jam is, it will belong in either one of two categories:\n\n- Batches are jams that are meant to be run over multiple club meetings, such as the lovely [AI assistant jam](https://jams.hackclub.dev/batch/artificial-intelligence) or the super fun [WebOS jam](https://jams.hackclub.dev/batch/webOS). These jams belong in the `batches` folder.\n- Singles are jams that are, well, meant to be run over a single club meeting, such as the useful [AI trip planner jam](https://jams.hackclub.dev/jam/ai-travel) or the [Hacker Card jam](https://jams.hackclub.dev/jam/hacker-card). These jams belong in the `singles` folder.\n\nInstructions for the two categories are as follows:\n\n\u003cdetails\u003e\n    \u003csummary\u003eCreating a batch jam\u003c/summary\u003e\n\u003cbr/\u003e\nHead over to `jams/batches`, and create a new folder with the name of your jam. Inside that folder, create a `readMe` folder, and create a new file inside `readMe` called `en-US.md` (or whatever your locale is) with the following content:\n\n```markdown\n---\ntitle: 'your title'\ncontributor: 'your github username'\ndescription: 'description of your batch jam'\nvideo: 'video (demo) of your batch jam'\nthumbnail: 'thumbail image link'\nkeywords: 'a, lis of, keywords separated by comma space'\ntimeEstimate: '4 Hours'\ndifficulty: '(Beginner, Intermediate, Difficult)'\nslug: 'a unique slug for people visiting your jam'\nisBatch: True\n---\n```\n\nWe use this info for this page:\n\n![Batch info](https://cloud-qitwm6rk9-hack-club-bot.vercel.app/0screenshot_2023-08-16_at_14-45-22_create_your_own_smart_ai_voice_companion.png)\n\nNow you can start writing the parts for your jam! For every part of your jam, create a folder inside your jam folder titled `part-\u003cpart #\u003e`. Create a file inside that folder called `en-US.md` (or whatever your locale is) and will it with the following content:\n\n```markdown\n---\npart: \"part-#\"\nbatch: 'slug of the parent batch for this jam'\ntotalParts: 'total number of parts in the jam'\ntitle: 'your title'\ndescription: 'a quick description!'\ncontributor: 'your GitHub username'\ncontributorSlackID: 'your Slack ID'\nthumbnail: 'thumbnail image link'\ntimeEstimate: ''\ndifficulty: '(Beginner, Intermediate, Difficult)'\nkeywords: 'a, list, of, keywords separated by comma space'\npresentation: 'link to figma slides'\npresentationPlay: 'link to figma slides in presentation mode'\npresentationPDF: 'link to pdf of slides'\nnotes: 'link to notes (optional)'\nposter: 'link to poster (optional)'\nvideo: 'link to video (optional)'\n---\n```\n\nNow start writing your batch jam!\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n    \u003csummary\u003eCreating a single jam\u003c/summary\u003e\n\u003cbr/\u003e\nHead over to `jams/singles`, and create a new folder with the name of your jam. Inside that folder, create a file called `en-US.md` (or whatever your locale is) with the following content:\n\n```markdown\n---\ntitle: 'your title'\ndescription: 'a quick description!'\ncontributor: 'your GitHub username'\ncontributorSlackID: 'your Slack ID'\nthumbnail: 'thumbnail image link'\ntimeEstimate: ''\ndifficulty: '(Beginner, Intermediate, Difficult)'\nkeywords: 'a, list, of, keywords separated by comma space'\npresentation: 'link to figma slides'\npresentationPlay: 'link to figma slides in presentation mode'\npresentationPDF: 'link to pdf of slides'\nnotes: 'link to notes (optional)'\nposter: 'link to poster (optional)'\nvideo: 'link to video (optional)'\nslug: 'a unique slug for people visiting your jam'\n---\n```\n\nNow start writing your jam!\n\n\u003c/details\u003e\n\n### Extra tips\n\n- Remember: every jam at the very least needs a presentation (preferably in Figma) to go along with it!\n- Save images, videos, and other assets using the `#cdn` channel on [Slack](https://hackclub.com/slack/)!\n- Please make sure to check for spelling and grammar mistakes before you make a PR! That'll save all of us some headaches and hassle.\n\n## Other ways to contribute\n\nThere are other ways to contribute besides writing a jam! We'd love some help with:\n\n- Translating the jams!\n- Helping us review jams!\n- Helping us make the jams website better, especially by helping us fix [issues](https://github.com/hackclub/jams/issues)!\n\nFeel free to start poking around the codebase and join the `#jams` channel on [Slack](https://hackclub.com/slack/)!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackclub%2Fjams","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhackclub%2Fjams","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackclub%2Fjams/lists"}