Rules

Adapted from Fallout

Submitting your Design

Okay, you’ve designed your project digitally! Congrats! Before giving you funding, the project needs to meet our ✨ Submission Requirements ✨

Pixl wants you to create real, shipped projects.

There are two key areas of our Design Submission Requirements:

  1. A good README
  2. Fully completed design

Missing any will get your project returned. Read through all of them! It’s easy to miss one.

95% of Rejections come from problems that take 5 Minutes to fix.

We’re here to help! But we can’t tell you exactly what to do. Before directly reaching out to us, read our documentation, ask in #pixl, Google it!

Note: missing any of these gets your project returned, and it goes to the back of the queue, so you wait a few more days for another review.

1. A Good README

Your README is people’s first impression. Make it awesome! Someone landing on your repository for the first time should understand:

  • What your project is
  • What it does
  • Why it exists

If they have to open even a single file, your README is not doing its job. At minimum, your README.md file must include:

  1. Explanation of what your project is
  • Short description of what your project is! Highlight what makes it unique
  • How do you use it? Be detailed! Others can’t read your mind.
  • Why did you make it? Be personal! Are you solving a problem? Trying to make something smaller than previously thought possible?
  1. Add images! A picture is worth a thousand words. Include:
  • Screenshots of a full 3D model of your project fully assembled
  • Screenshots of your PCB with components, if you have one
  • A clear wiring diagram, if you’re not using a PCB
  • Anything else that makes it clear what your project is and what it’s for

2. A fully finished design:

Whoa… A lot at first glance! Breathe. You got this. It’s simpler than it seems!

For a design to be 100% finished, someone else should be able to read your repo, understand, and replicate it… i.e. You need to include all files and instructions!

A project that only you can make is not shipped. It only lives in your head.

The design should also reasonably actually work! Of course, you can’t be sure until building it, but stuff like floating parts, incomplete firmware, or parts attached with “magic” is a no-go.

At minimum, your project should be:

  • Original, custom design by you. Not by AI, not a direct copy of a tutorial, or someone else.
  • Has a complete CAD assembly, with all components (including electronics).
  • Have a concrete way to attach components (including electronics). Use screws, clips, etc. This is a product, not a demo, it should feel solid, and not held up by tape, glue, and dreams.
  • Has firmware if applicable, even if it’s untested. If you have a microcontroller, you should probably have firmware.
  • Someone else sanity checked your design! It’s EASY to miss things. Ask a friend, in #pixl, and fix them before submitting!

Your GitHub repository needs to contain all your project files

  • A BOM (Bill of Materials) in CSV format, with links, and a line indicating the total cost! Even if you own a part, still include it. Someone else needs to be able to build what you’ve designed
  • The source files of your PCB, if you have one (.kicad_pro, .kicad_sch, .kicad_pcb, .epro, gerbers.zip, etc)
  • If you have 3D models, .step files of your project’s 3D CAD and the source design file (.f3d, FCStd, or a link to onshape)
  • Your firmware files, if applicable. Make sure to include the source code
  • ANY other files that are part of your project (libraries, references, etc.)
  • Make sure your repository is well organized. Use and name folders and files clearly

You shouldn’t have

  • Designs copied from other people. It’s okay to reference or use parts of other’s work. Make sure to credit it. Never present others’ work as your own.
  • Missing files! Check the above

Note : Any project containing plagiarized content, Fully AI generated design files or stolen work may be permanently rejected and could even result in a ban from Hack Club programs.

Submitting your build

Whoaa! You built the thing you designed. Now it's time to get it approved so you can spend the pixels in the shop.

To submit a build, lapse the building phase and journal it. If you don't lapse it, we might deflate the time accordingly.

  • It should have several pictures of the build in journals to show the progress.
  • Pictures of the finished build, plus a link to a demo video, in the repo's README.
  • If you changed anything while building, like bodging a wire for a connection you forgot, update the PCB and the repo to match.

Note: submitting a build means meeting the design submission requirements too. Miss them and the project comes back for changes, and you wait for the next review round again.

Built by the Pixl team