Submission form made better

platane
platane
Aug 25 · 2 min read
Image for post
Image for post
Submission validation bot

Hello js13kGames participants! We have good news concerning the submission process this year.

What’s wrong with the current form?

As the number of participants grow, it’s more and more time consuming each year to check manually that the submitted games are valid (ie: don’t break the rules, don’t throw any errors in the console, etc).

Most of the time those are small fixes, but communication between the reviewer and the participant is mostly done by email, which is not perfect to say the least.

Lessons from previous years

Last year we introduced a whole new submission flow through GitHub pull requests. We learned some lessons from the ~100 participants who used it:

  • As expected, it did help to eliminate some basic failures at the source.
  • The process was very confusing. The PR and release steps created a lot of friction. Especially for devs with less experience, problematically the ones we want to help the most.
  • Communication with PR comment was helpful yet marginal.

Today’s solution

So we ditched the GitHub flow, and went with something easier. We are now providing an endpoint hooked to the submit form you already know, which will run some checks on the zip package you attach to it.

On the file selection, it runs the checks automatically and display either a satisfying list of green checks, or hints on how to solve the given problems.

Image for post
Image for post
While filling the form, the bundle is analyzed and report is displayed below the .zip package input

Notice that you are allowed to submit anyway in case you think the report is wrong. And if you need help with your entry, the Slack channel is full of people willing to help you!

And more

Thanks to BrowserStack for supporting Open Source and providing us with a platform to test each submission ❤️

The bot’s source code is hosted on Github. The endpoint is public, feel free to use it as part of your personal build process (although we might migrate to a proper domain at some point in time).

In the future we might offer a Github action that you can plug to your repository. Maybe you can help with that? Or you are thinking of some advanced checks that you want to add? PRs are welcome! :)

js13kGames

Js13kGames is a JavaScript coding competition for HTML5…

platane

Written by

platane

dev

js13kGames

Js13kGames is a JavaScript coding competition for HTML5 Game Developers. The fun part of the compo is the file size limit set to 13 kilobytes. It runs between August 13th and September 13th, online since 2012.

platane

Written by

platane

dev

js13kGames

Js13kGames is a JavaScript coding competition for HTML5 Game Developers. The fun part of the compo is the file size limit set to 13 kilobytes. It runs between August 13th and September 13th, online since 2012.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store