{"id":19030882,"url":"https://github.com/hackclub/assemble","last_synced_at":"2025-10-25T06:02:46.203Z","repository":{"id":54347989,"uuid":"496556366","full_name":"hackclub/assemble","owner":"hackclub","description":"🌁 The behind-the-scenes of the first high school hackathon since the pandemic! ","archived":false,"fork":false,"pushed_at":"2023-09-01T06:29:19.000Z","size":7459,"stargazers_count":76,"open_issues_count":0,"forks_count":5,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-10-12T04:18:00.387Z","etag":null,"topics":["assemble-hackclub","hackathon","organising"],"latest_commit_sha":null,"homepage":"https://assemble.hackclub.com/launch","language":"Assembly","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":"2022-05-26T09:22:54.000Z","updated_at":"2025-08-17T23:23:42.000Z","dependencies_parsed_at":"2025-04-23T16:18:39.992Z","dependency_job_id":null,"html_url":"https://github.com/hackclub/assemble","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hackclub/assemble","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackclub%2Fassemble","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackclub%2Fassemble/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackclub%2Fassemble/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackclub%2Fassemble/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hackclub","download_url":"https://codeload.github.com/hackclub/assemble/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackclub%2Fassemble/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279015893,"owners_count":26085777,"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","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["assemble-hackclub","hackathon","organising"],"created_at":"2024-11-08T21:19:55.979Z","updated_at":"2025-10-13T15:05:47.700Z","avatar_url":"https://github.com/hackclub.png","language":"Assembly","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Assemble ~ 5th August to 7th August](https://user-images.githubusercontent.com/39828164/184644927-e0c0baef-e299-4e91-9136-784090a1e098.png)](https://www.youtube.com/watch?v=PnK4gzO6S3Q)\n\n[🎬 The Mini-Documentary](https://www.youtube.com/watch?v=PnK4gzO6S3Q) ~ [✨ The Philosophy](#-the-philosophy) ~ [📆 The Event](#-the-event) ~ [🫂 The Attendees](#-the-attendees) ~ [💸 The Budget](#-the-budget) ~ [📌 The Venue](#-the-venue) ~ [📚 Further Reading](#-further-reading)\n\n---\n\nMany Hack Clubbers in 2022 had heard about great IRL hackathons, but very few had been to one. They vanished when the pandemic hit, and went missing as the world emerged from the pandemic. Our 2022 summer project was to kick off a hackathon renaissance, together with Hack Clubbers.\n\nTo do this, we hosted [the first major high-school hackathon](https://www.youtube.com/watch?v=PnK4gzO6S3Q) since 2020, [open sourced](https://github.com/hackclub/assemble) the entire event \u0026 [launched a series of supports](https://hackclub.com/hackathons/) for high school hackathon organisers based on our experience.\n\nThe goal of this repository is to be a reference for high schoolers looking to organise their own hackathon. No hackathon is the same but we hope that within this repository you can find inspiration for you own special event.\n\nLooking for a how-to? Read [An Expandable Guide to Hackathon Organizing](https://expandables.hackclub.dev/organizing.html).\n\n## ✨ The Philosophy\n\n\u003cimg width=\"600\" alt=\"Hacker reverse engineering a power extender!\" src=\"https://user-images.githubusercontent.com/39828164/189932518-93a9b110-7e29-410c-973c-ac7fd6a8eb04.png\"\u003e\n\nA [hackathon](https://hackclub.com/hackathons) is not an extracurricular or a club. It's not a class or a lecture. Hackathons are a place to build things for fun and meet others doing the same. Going into organising Assemble, [we brainstormed what a magical hackathon looked like](/further-reading/magic.md), from those brainstorms we developed the following framework for a great hackathon:\n\n- Hackers are prompted to create weird \u0026 wacky projects.\n- Hackers feel ownership of the event.\n- Hackers walk away with a set of unique and memorable experiences.\n- Hackers are provided with the opportunity to form personal connections.\n- Organisers are consistently involved and passionate at the event.\n\n[Read more about Hack Club's Philosophy ➚](https://hackclub.com/philosophy/)\n\n## 📆 The Event\n\n\u003cimg width=\"600\" alt=\"Hacker demoing their project.\" src=\"https://user-images.githubusercontent.com/39828164/189933879-c5a788b6-dfbe-4124-a985-33ff2b98dbbb.png\"\u003e\n\nAssemble ran from 6PM on Friday to 12PM on Sunday. That's 42 hours to make our own. Creating a great hackathon, means designing a spectacular attendee experience as well as a great organiser experience. There are a fair few components to this including, but not limited to, planned (as well as unplanned) [activities](/the-event/fun.md), [judging](/the-event/judging.md), [swag](/the-event/swag.md), [food](/the-event/food.md) and [ceremonies](/the-event/ceremonies.md). The specifics of each at Assemble are detailed in their respective files in [`/the-event`](/the-event).\n\n\u003cimg width=\"600\" alt=\"An dinosaur* makes an expected appearance at the event!\" src=\"https://user-images.githubusercontent.com/39828164/189933643-e31d5ef7-cc9e-4d84-a8d5-1fe152278622.png\"\u003e\n\n[Read more in `/the-event` ➚](/the-event)\n\n## 🫂 The Attendees\n\n\u003cimg width=\"600\" alt=\"Everyone at Assemble cheering!\" src=\"https://user-images.githubusercontent.com/39828164/189933158-9f00ceaf-7f61-4bef-9911-4cf4a14e0e4d.png\"\u003e\n\nThere's only so much organisers can do to make a wonderful hackathon, it is the attendees who bring a hackathon alive. As an organiser, your role in this process is to make sure [everyone who needs to hear about your hackathon does](/the-attendees/marketing.md), to convert these potential participants into attendees, to [make sure they're all set](/the-event/communication.md) for the event and then to inspire them to embrace the spirit of the hackathon. At the same time, you may choose to invite non-high schoolers to mentor and talk with the attendees. At Assemble, we wanted to make sure such relationships were casual and human, an approach you can read more about [here](/the-attendees/guests.md).\n\n[Read more in `/the-attendees` ➚](/the-attendees)\n\n## 💸 The Budget\n\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fbank-shields.hackclub.com%2Forganizations%2Fassemble%2Fbalance)](https://bank.hackclub.com/assemble)\n\nAssemble had a budget of \\$75,000, that's a large budget for a high school hackathon. HS hackathon budgets can range anywhere from \\$500 to \\$75,000. Whatever your budget is, you'll find a similar set of expenses will arise between all hackathons. Every expense made for Assemble has been open sourced [here](https://bank.hackclub.com/assemble) through HCB's [transparency mode](https://headwayapp.co/bank-changelog/transparent-finances-optional-feature-151427). As an organiser, you'll need to [raise money](/the-budget/sponsorships.md), [create an itemized budget](/the-budget/budgeting.md) (which accounts for the unexpected) and then [spend the money](/the-budget/bank.md) raised as planned.\n\n[Explore our budget sheet ➚](https://docs.google.com/spreadsheets/d/1zr2hHsi_i6P47KuUvGP_iPHTNwT3MXwTWJvLFCk2Dck/edit?usp=sharing) or [read more in `/the-budget` ➚](/the-budget)\n\n## 📌 The Venue\n\n\u003cimg width=\"600\" alt=\"The courtyard of Figma's office.\" src=\"https://user-images.githubusercontent.com/39828164/189934800-a937e5be-264a-4a2b-a8dc-a3b5eeefa15f.png\"\u003e\n\nSince the pandemic began, [finding a venue](/the-venue/finding.md) has became by far the most challenging aspect of organising a hackathon. Assemble was hosted across two floors in Figma's San Francisco office, situated in the [Phelan Building](https://en.wikipedia.org/wiki/Phelan_Building) on Market Street. Getting there took almost 40% of the time spent organising the event, however, when the event rolled around it was well and truly worth it. Figma's space was creatively inspiring and provided the perfect home for Assemble. As an organiser, you'll need to make pitches to potential venues, convince a venue to buy into your event, set up the venue for success and finish by making the venue provider [feel appreciated](/the-venue/thanking.md).\n\n[Read more in `/the-venue` ➚](/the-venue)\n\n## 📚 Further Reading\n\nBelow you can find a series of resources curated and created by the Assemble team that we hope will help you when organising your own events.\n\n### 📝 Assembling Assemble\n\nThe majority of work on Assemble was done in a month, from July 5th to August 5th. Every week of that month, [@sampoder](https://github.com/sampoder) wrote a journal update on the Assemble organising process. Together they tell the story of how Assemble went from an idea to an event for 175 hackers.\n\n[👋 Issue #1: Getting Started in Vermont, July 8th](updates/1.md)\n\n[😫 Issue #2: Everything Gets Really Difficult Really Fast, July 15th](updates/2.md)\n\n[👣 Issue #3: Gaining My Footing, July 24th](updates/3.md)\n\n[🎉 Issue #4: Starting To See Light At The End of The Tunnel, July 30th](updates/4.md)\n\n[👨‍🚒 Issue #5: Seeing The Event Across The Line, August 5th](updates/5.md)\n\n[😥 Issue #6: Looking Back, August 13th](updates/6.md)\n\n### 📸 Photography\n\nAcross this repository, you'll find the fabulous photographs of Assemble by [@kunalbotla](https://github.com/kunalbotla), a Hack Clubber from Boston. The full album can be found here (all Hack Clubbers can use these photos in their projects!): [hack.af/assemble-photos](https://hack.af/assemble-photos). We also have a collaborative album amongst attendees: [hack.af/assemble-album](https://hack.af/assemble-album).\n\n\u003cimg width=\"600\" alt=\"Hackers assembled in the park.\" src=\"https://user-images.githubusercontent.com/39828164/190546801-707fcaee-f97c-4fad-ac0f-5ebaa7764d1e.png\"\u003e\n\n### 💻 Associated Repositories\n\n- The website: https://github.com/hackclub/www-assemble\n- The registration form: https://github.com/hackclub/assemble-register\n- The midnight CTF: https://github.com/hackclub/assemble-midnight-ctf\n- The schedule for attendees at the event: https://github.com/hackclub/assemble-schedule\n- Our voting and judging system for the event: https://github.com/hackclub/assemble-scrapbook\n- The print system supporting scrapbook: https://github.com/hackclub/assemble-print\n- A fun activity during check-in: https://github.com/hackclub/assemble-tv-thing\n- System to collect proof of vaccination and negative test results as well as distributing tickets: https://github.com/hackclub/assemble-preflight-web\n- (Unused) System to choose prompt: https://github.com/hackclub/assemble-prompter\n- Puzzle leading up to launch: https://github.com/hackclub/assemble-puzzle\n\n### ☀️ In Years Past\n\nWe've previously ran other summer projects, learn more about them:\n\n| Year | Project                                                            | Description                                                                                                                                                                                                                                                                           |\n| ---- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| 2022 | [Assemble](https://assemble.hackclub.com)                          | _This repo!_                                                                                                                                                                                                                                                                          |\n| 2021 | [The Hacker Zephyr](https://github.com/hackclub/the-hacker-zephyr) | A cross-country hacker adventure on a train! ([repo](https://github.com/hackclub/the-hacker-zephyr)) ([finances](https://bank.hackclub.com/zephyr))                                                                                                                                   |\n| 2020 | [Summer of Making](https://summer.hackclub.com)                    | $50k in hardware donations to teen hackers around the world + the creation of [Scrapbook](https://scrapbook.hackclub.com) ([code](https://github.com/hackclub/scrapbook)) ([finances](https://bank.hackclub.com/summer-of-making))                                                    |\n| 2019 | [Flagship Summit](https://flagship.hackclub.com)                   | IRL meetup of high school hackathon organizers and coding club leaders ([photos](https://photos.google.com/share/AF1QipO3hb2mN-Q16icE-M16d-06uHyXLmvd3Rw6b_f_oosfAX9SnOvnouPOyO79P7pR7Q?key=anphZTNFUERPWXV3YnJQV2VzVVVFMFFVcGRDc3hB))                                                |\n| 2018 | [HCB](https://hackclub.com/bank/)                       | We built and launched the first version of HCB (read the [1st](https://medium.com/hackclub/hack-club-bank-a-bank-for-student-hackers-e5d894ea5375) and [2nd](https://medium.com/hackclub/hack-club-bank-is-now-live-for-everyone-including-you-884f7f54836f) announcement) |\n| 2016 | [Hack Camp](https://github.com/hackclub/camp/tree/master/2016)     | Summer camp / further writing \u0026 testing workshops                                                                                                                                                                                                                                     |\n| 2015 | [Hack Camp](https://github.com/hackclub/camp/tree/master/2015)     | Summer camp / testbed for Hack Club's first [workshops](https://workshops.hackclub.com) ([content](https://github.com/hackclub/hackclub/tree/main/workshops#readme))([code](https://github.com/hackclub/workshops))                                                                   |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackclub%2Fassemble","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhackclub%2Fassemble","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackclub%2Fassemble/lists"}