đ Welcome to Hacktoberfest 2025! đ
Itâs time to flex your creativity and snag awesome swag. Built a Discord bot, activity, or website? Prefer teaching with videos instead of code? Either works!đ
Every participant gets Discord Nitro. Top contributors earn an exclusive Robo.js Hacktoberfest 2025 TâShirt, upgrades, and cash. The more people join, the bigger (and better) the prize pool gets. đ
Event window: October 1â31, 2025
âš What is Robo.js?
Robo.js is a framework for building Discord Bots, Discord Activities, and Web Appsâwith batteries included. It streamlines your workflow via plugins, sensible defaults, and a smooth DX so you can ship faster.
Hereâs what you can expect:
- Ecosystem: A growing directory of plugins, templates, and tools to help you move from idea to MVP in record time.
- Integrated Database: A built-in KV store (Flashcore) with adapters so you can point at your favorite data source.
- TypeScript Support: First-class TypeScript, zero config required.
Check out the Getting Started guide.
Note: Robo.js does not replace Discord.js for bots. Itâs a higher-level framework that helps you build more complex projects with less effort. Bring your favorite librariesâRobo.js plays nicely with them.
đ§Ș Our Vibe on Coding
We accept vibe coding as long as your contribution - and please actually read and review the code you generate (donât just hope AI got it right).
- Works and does exactly what it claims.
- Is wellâtested (unit/integration where appropriate) with clear steps to verify.
- Has clean code (readable, typed, documented) and passes lint/build checks.
- Comes with a concise README and examples where relevant.
To help you ship faster, we have several AGENTS.md
files scattered throughout the monorepo to guide AI coding tools (e.g., Codex, Claude Code) with context, patterns, and commands. Feel free to rely on them while you build.
đ Rewards
As participation grows, so do the rewards.
Starting Rewards
- Exclusive Robo.js Hacktoberfest 2025 TâShirt for the top 3 contributors
- Free Discord Nitro for everyone who makes a meaningful contribution, while supplies last
- $25 USD optional alternative for the top contributor
Stretch Rewards
- Over 10 Participants: Add a free month of RoboPlay for the top 3 contributors.
- Over 25 Participants: Expand topâcontributor rewards to top 5. Cash prize increases to $50 USD.
- Over 50 Participants: Top 5 may upgrade their TâShirt to a higher prize tier. Cash prize increases to $100 USD.
- Over 75 Participants: All top participants receive event stickers.
- Over 100 Participants: Expand topâcontributor rewards to top 10. Cash prizes extend to top 3.
Cash prizes are sent via PayPal or another agreed method. Rewards may be limited by local laws or restrictions.
Share the event to unlock every milestone! đ
đ How to Participate
Contribute plugins, templates, video content, or features to the core framework. Every meaningful contribution is an entryâsubmit more, increase your odds.
Getting started is easy:
npx create-robo <project-name>
Boom! Youâve scaffolded a Robo.js project. Build something cool and send a PR to qualify. đ
Contributions must add real value. âHello Worldâ plugins wonât count, but anything that unlocks new interactions or improves the dev experience willâeven if itâs not for Discord!
đ§ź Points & Contribution Types
Each accepted contribution type earns points. Points (plus impact and quality) help determine top contributors.
đ Bug Fix (1 point)
Fix a bug in the core or an official plugin. Documentation-only changes donât count for points (but we still â€ïž them).
đŠ Template (2 points)
Templates are ready-made project starters. Examples: a music-enabled Discord bot, a quiz activity, or a streamlined web app.
đ§© Plugin â 7â10 points
NPM packages that snap extra features into Robo.js (e.g., command packs, dashboards, storage adapters, integration bridges).
Scoring guidance: Complexity, test coverage, UX polish, docs, and adoption potential push you toward the 10 end of the range.
đ„ Video Tutorial â 5 points
Teach the communityârecord a walkthrough, liveâcoding session, or deepâdive. Upload to YouTube and PR the link.
đ§ Core Framework Feature â 3â5 points
Propose and ship a scoped core feature (after community discussion). Start a thread, align on scope, and follow the contribution guidelines.
If in doubt, start with a plugin or template; many ideas shine better outside core.
đ Prepared #hacktoberfest Issues
Weâve prepped wellâdetailed issues to help you hit the ground running. Most include optional bonus features that can grant extra points beyond their base value if implemented. These are just a fewâthere are more #hacktoberfest
issues across the repo.
Note: Links below are placeholdersâyouâll find the real links in the issue tracker.
- @robojs/prefix â Prefix Commands Plugin (plugin)
- @robojs/social â Social Alerts (Twitch, YouTube, RSS/Atom)** â Social Alerts (Twitch, YouTube, RSS/Atom)** (plugin) â
- @robojs/welcome â Welcome & Goodbye for Discord bots (plugin)
- @robojs/giveaways â One-click Discord giveaways â Oneâclick Discord giveaways** (plugin) â
-
@robojs/cooldown
â Cooldowns & RateâLimiting** (plugin) â -
@robojs/announcements
â Scheduled announcements for servers** (plugin) â -
@robojs/tickets
â Threadâbased support tickets** (plugin) â
Tip: Many issues have a âGood first issueâ label and include acceptance criteria, test hints, and bonus ideas.
đš Creation Ideas
Need inspiration? Try these starters.
đź Discord Activities
- Game Engine Template: Unity, Unreal, or Godot wired to Robo.js.
-
Live Whiteboard: Realâtime drawing via WebSockets or
@robojs/sync
. - Video Tutorial: From setup to multiplayerâshow your build and thought process.
đ€ Discord Bots
- Music Bot Template: Playback, queues, and intuitive UX.
- Ticketing & Support Threads Plugin: Create, route, and autoâclose support tickets with transcripts, tags, and slash commands.
- Video Tutorial: Walk through commands, modals, embeds, and permissions.
đ Other Suggestions
- Integration Templates: Pair Robo.js with Better Stack, Notion, or another favorite service.
- Bot Dashboard Plugin: Settings, logs, analyticsâoptionally as a Discord Activity.
- Video Showcase: Demo your coolest Robo.js buildâwhat it does and how you made it.
â What We Look For (Quality Signals)
- Clear problem/solution summary and scope.
- Tests (unit/integration) and easy repro steps.
- Clean code: types, naming, comments, and small PRs.
- Docs & examples: README, usage notes, screenshots or gifs.
- DX polish: sensible errors, helpful logs, zeroâconfig defaults where possible.
Spread the Word!
Invite friends, post your progress, and help us smash every milestone. The more builders we have, the better the rewards for
Questions? Need a hand getting started? Hop in our Discord Server â weâre excited to see what you create!
Happy coding and happy Hacktoberfest 2025! đ
Top comments (1)
Love the clear scoring and vibe-coding honestyâNitro bait noted. Great idea list; watch those duplicate issue lines though.