TerminalCraft

TerminalCraft is an indefinite You Ship We Ship program that rewards teenagers for creating original terminal-based programs with hardware grants for hackable electronics and hardware-project supplies.

🎯 The Challenge

Create an original program that runs in the terminal. If your submission is approved, you'll receive a hardware grant at $4 per approved Hackatime hour to spend on hackable electronics like Arduino boards, Raspberry Pi boards, sensors, components, tools, and other items specifically for hardware projects.

🌐 Resources

• Website: terminalcraft.hackclub.com
• Slack Channel: #terminal-craft

⏳ Program Status

TerminalCraft is now indefinite. There is no fixed deadline currently listed for submissions.

📝 Submission Requirements

1. Self-Contained: Your program must be self-contained and should not assume the existence of another program on the computer that it can take advantage of.

2. API Independence: The program must not be entirely dependent on external APIs.

3. Originality: It must not be a remake of an existing terminal program or game.

4. No Wrappers: It must not be a wrapper around an existing program/API to make it "nicer".

5. Linux Compatibility: Your program must be able to run on Linux. You must provide pre-built binaries that can run on Linux without requiring compilation.

6. Terminal-Only: Your program must run entirely in the terminal and must not depend on a graphical user interface (GUI).

7. Coding Time Tracking: You must track all your coding time using Hackatime. A minimum of 10 hours of logged development time is required for your submission to be eligible.

8. No Double-Dipping: This program is not double-dippable.

🚀 How to Submit

1. Fork this repository
2. Create a new folder in the submissions directory with your project name
3. Add your project files and a README.md explaining your project
4. Submit your project on Hack Club Slack with the /craftr command

Your submission should include:

• Source code
• Pre-built Linux binaries
• A README.md explaining:
  • What your program does
  • How to run it
  • Any dependencies or requirements
  • Why you created it

🎁 The Reward

If your submission is approved, you'll receive a hardware grant at $4 per approved Hackatime hour.

The grant is for hackable electronics and hardware-project supplies, such as Arduino boards, Raspberry Pi boards, sensors, components, tools, and other items specifically for hardware projects.

Outstanding projects can receive an additional $10 to $30 grant depending on the quality, creativity, usefulness, and polish of the project.

💡 Project Ideas

Here are some unique ideas to get you started:

• A terminal-based procedural dungeon generator with interactive exploration
• A text-based particle system simulator with physics
• A command-line tool that visualizes sorting algorithms with ASCII art
• A terminal-based music synthesizer that creates sounds using mathematical functions
• A text-based roguelike game with unique mechanics
• Terminal-Based Time Capsule
• Terminal-Only Spreadsheet App
• ASCII Neural Network Visualizer

Remember: The more original and creative your project is, the better! These are just starting points - feel free to come up with your own unique ideas!

🤝 Need Help?

Join the #terminal-craft channel on the Hack Club Slack to:

• Get help with your project
• Share your progress
• Connect with other participants
• Ask questions about the program