EMF Badge - User contributions [en]

TiLDA MK4/Badge Store Submissions

2018-08-29T18:16:19Z

Steve Amor:

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.

== Packaging up your badge app for submission to the store ==

Every app becomes a new folder in the root of the Mk4-App GitHub repository. So if you create a "snake" app, you need to put your program files in a folder called "snake" with at least a "main.py" in it.

App names need to be unique (the folder structure enforces that). App folders can contain multiple files (python and non python), but at a minimum "main.py" with the correct headers is required.

Plesae verify that your apps folder structure is correct by running "./tilda_tools validate" (this works without a badge) before submitting it to the badge app store as the validations is also run by Travis to check pull requests.

=== Headers ===

main.py headers:

<pre>
___name___ = "<your_app_name>"
___license___ = "MIT"
___dependencies___ = ["wifi", "http", "ugfx_helper", "sleep"]
___categories___ = ["<see below>"]
___bootstrapped___ = True # Whether or not apps get downloaded on first install. Defaults to "False", mostly likely you won't have to use this at all.
</pre>

Please use one of these categories:
* System
* Homescreens
* Games
* Sound
* EMF
* Villages
* Phone
* LEDs
* Sensors
* Demo
* Other

== Submitting your badge app to the official badge store ==

* Create a GitHub account [https://github.com/join]
* Download and install git on your local computer [https://git-scm.com/downloads]
* Set up git on your local computer with your username and email address [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Fork the emfcamp/Mk4-Apps repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Clone '''your''' GitHub repo to your computer [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Add your app to your local repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Create a Pull Request [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]

* Over time, your GitHub report will get out of sync with the changes that have been made to the emfcamp/Mk4-Apps repo so you will need to update your GitHub repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#updating-your-github-and-local-git-repo]

If you prefer a GUI interface, you could consider https://desktop.github.com/

TiLDA MK4/Badge Store Submissions

2018-08-29T18:16:01Z

Steve Amor: /* Submitting your badge app to the official badge store */

Todo: Please elaborate on these steps

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.

== Packaging up your badge app for submission to the store ==

Every app becomes a new folder in the root of the Mk4-App GitHub repository. So if you create a "snake" app, you need to put your program files in a folder called "snake" with at least a "main.py" in it.

App names need to be unique (the folder structure enforces that). App folders can contain multiple files (python and non python), but at a minimum "main.py" with the correct headers is required.

Plesae verify that your apps folder structure is correct by running "./tilda_tools validate" (this works without a badge) before submitting it to the badge app store as the validations is also run by Travis to check pull requests.

=== Headers ===

main.py headers:

<pre>
___name___ = "<your_app_name>"
___license___ = "MIT"
___dependencies___ = ["wifi", "http", "ugfx_helper", "sleep"]
___categories___ = ["<see below>"]
___bootstrapped___ = True # Whether or not apps get downloaded on first install. Defaults to "False", mostly likely you won't have to use this at all.
</pre>

Please use one of these categories:
* System
* Homescreens
* Games
* Sound
* EMF
* Villages
* Phone
* LEDs
* Sensors
* Demo
* Other

== Submitting your badge app to the official badge store ==

* Create a GitHub account [https://github.com/join]
* Download and install git on your local computer [https://git-scm.com/downloads]
* Set up git on your local computer with your username and email address [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Fork the emfcamp/Mk4-Apps repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Clone '''your''' GitHub repo to your computer [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Add your app to your local repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Create a Pull Request [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]

* Over time, your GitHub report will get out of sync with the changes that have been made to the emfcamp/Mk4-Apps repo so you will need to update your GitHub repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#updating-your-github-and-local-git-repo]

If you prefer a GUI interface, you could consider https://desktop.github.com/

TiLDA MK4/Badge Store Submissions

2018-08-29T18:13:58Z

Steve Amor:

Todo: Please elaborate on these steps

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.

== Packaging up your badge app for submission to the store ==

Every app becomes a new folder in the root of the Mk4-App GitHub repository. So if you create a "snake" app, you need to put your program files in a folder called "snake" with at least a "main.py" in it.

App names need to be unique (the folder structure enforces that). App folders can contain multiple files (python and non python), but at a minimum "main.py" with the correct headers is required.

Plesae verify that your apps folder structure is correct by running "./tilda_tools validate" (this works without a badge) before submitting it to the badge app store as the validations is also run by Travis to check pull requests.

=== Headers ===

main.py headers:

<pre>
___name___ = "<your_app_name>"
___license___ = "MIT"
___dependencies___ = ["wifi", "http", "ugfx_helper", "sleep"]
___categories___ = ["<see below>"]
___bootstrapped___ = True # Whether or not apps get downloaded on first install. Defaults to "False", mostly likely you won't have to use this at all.
</pre>

Please use one of these categories:
* System
* Homescreens
* Games
* Sound
* EMF
* Villages
* Phone
* LEDs
* Sensors
* Demo
* Other

== Submitting your badge app to the official badge store ==

* Create a GitHub account [https://github.com/join]
* Download and install git on your local computer [https://git-scm.com/downloads]
* Set up git on your local computer with your username and email address [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Fork the emfcamp/Mk4-Apps repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Clone '''your''' GitHub repo to your computer [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app] (maybe mention https://desktop.github.com/ ?)
* Add your app to your local repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]
* Create a Pull Request [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#using-git-and-github-to-submit-your-badge-app]

* Over time, your GitHub report will get out of sync with the changes that have been made to the emfcamp/Mk4-Apps repo so you will need to update your GitHub repo [https://github.com/emfcamp/Mk4-Apps/blob/master/CONTRIBUTING.md#updating-your-github-and-local-git-repo]

TiLDA MK4/Badge Store Submissions

2018-08-29T17:33:53Z

Steve Amor: /* Packaging up your badge app for submission to the store */

Todo: Please elaborate on these steps

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.

== Packaging up your badge app for submission to the store ==

Every app becomes a new folder in the root of the Mk4-App GitHub repository. So if you create a "snake" app, you need to put your program files in a folder called "snake" with at least a "main.py" in it.

App names need to be unique (the folder structure enforces that). App folders can contain multiple files (python and non python), but at a minimum "main.py" with the correct headers is required.

Plesae verify that your apps folder structure is correct by running "./tilda_tools validate" (this works without a badge) before submitting it to the badge app store as the validations is also run by Travis to check pull requests.

=== Headers ===

main.py headers:

___name___ = "<your_app_name>" 
___license___ = "MIT" 
___dependencies___ = ["wifi", "http", "ugfx_helper", "sleep"] 
___categories___ = ["<see below>"] 
___bootstrapped___ = True 

Please use one of these categories:
* System
* Homescreens
* Games
* Sound
* EMF
* Villages
* Phone
* LEDs
* Sensors
* Demo
* Other

== Submitting your badge app to the official badge store ==

* Create a GitHub account [https://github.com/join]
* Download and install git on your local computer [https://git-scm.com/downloads]
* Set up git on your local computer with your username and email address (link to set up user and email)
* Fork the emfcamp/Mk4-Apps repo (link)
* Clone '''your''' GitHub repo to your computer (link) (maybe mention https://desktop.github.com/ ?)
* Add your app to your local repo (link)
* Create a Pull Request (link)

* Over time, your GitHub report will get out of sync with the changes that have been made to the emfcamp/Mk4-Apps repo so you will need to update your GitHub repo (link)

TiLDA MK4/Badge Store Submissions

2018-08-29T17:19:03Z

Steve Amor: /* Packaging up your badge app for submission to the store */

TiLDA MK4/Badge Store Submissions

2018-08-29T17:18:33Z

Steve Amor: /* Packaging up your badge app for submission to the store */

TiLDA MK4/Badge Store Submissions

2018-08-29T15:36:32Z

Steve Amor:

TiLDA MK4/Badge Store Submissions

2018-08-29T14:18:22Z

Steve Amor:

Todo: Please elaborate on these steps

== Packaging up your badge app for submission to the store ==

Todo: How to package up your badge app for submission to the store

== Submitting your badge app to the official badge store ==

* Create a GitHub account [https://github.com/join]
* Download and install git on your local computer [https://git-scm.com/downloads]
* Set up git on your local computer with your username and email address (link to set up user and email)
* Fork the emfcamp/Mk4-Apps repo (link)
* Clone '''your''' GitHub repo to your computer (link) (maybe mention https://desktop.github.com/ ?)
* Add your app to your local repo (link)
* Create a Pull Request (link)

* Over time, your GitHub report will get out of sync with the changes that have been made to the emfcamp/Mk4-Apps repo so you will need to update your GitHub repo (link)

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.

TiLDA MK4/Badge Store Submissions

2018-08-29T14:17:58Z

Steve Amor:

Todo: Please elaborate on these steps

Todo: How to package up your badge app for submission to the store

== Packaging up your badge app for submission to the store ==

== Submitting your badge app to the official badge store ==

* Create a GitHub account [https://github.com/join]
* Download and install git on your local computer [https://git-scm.com/downloads]
* Set up git on your local computer with your username and email address (link to set up user and email)
* Fork the emfcamp/Mk4-Apps repo (link)
* Clone '''your''' GitHub repo to your computer (link) (maybe mention https://desktop.github.com/ ?)
* Add your app to your local repo (link)
* Create a Pull Request (link)

* Over time, your GitHub report will get out of sync with the changes that have been made to the emfcamp/Mk4-Apps repo so you will need to update your GitHub repo (link)

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.

TiLDA MK4/Badge Store Submissions

2018-08-29T14:10:31Z

Steve Amor: /* Submittinh your badge app to the official badge store */

Todo: Please elaborate on these steps

Todo: How to package up your badge app for submission to the store

=== Packaging up your badge app for submission to the store ===

=== Submitting your badge app to the official badge store ===

* Create a GitHub account [https://github.com/join]
* Download and install git on your local computer [https://git-scm.com/downloads]
* Set up git on your local computer with your username and email address (link to set up user and email)
* Fork the emfcamp/Mk4-Apps repo (link)
* Clone '''your''' GitHub repo to your computer (link) (maybe mention https://desktop.github.com/ ?)
* Add your app to your local repo (link)
* Create a Pull Request (link)

* Over time, your GitHub report will get out of sync with the changes that have been made to the emfcamp/Mk4-Apps repo so you will need to update your GitHub repo (link)

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.

TiLDA MK4/Badge Store Submissions

2018-08-29T14:10:16Z

Steve Amor:

Todo: Please elaborate on these steps

Todo: How to package up your badge app for submission to the store

=== Packaging up your badge app for submission to the store ===

=== Submittinh your badge app to the official badge store ===

* Create a GitHub account [https://github.com/join]
* Download and install git on your local computer [https://git-scm.com/downloads]
* Set up git on your local computer with your username and email address (link to set up user and email)
* Fork the emfcamp/Mk4-Apps repo (link)
* Clone '''your''' GitHub repo to your computer (link) (maybe mention https://desktop.github.com/ ?)
* Add your app to your local repo (link)
* Create a Pull Request (link)

* Over time, your GitHub report will get out of sync with the changes that have been made to the emfcamp/Mk4-Apps repo so you will need to update your GitHub repo (link)

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.

TiLDA MK4/Badge Store Submissions

2018-08-29T13:04:42Z

Steve Amor:

Todo: Please elaborate on these steps

To submit your badge app to the official badge store, you will need to:

* Create a GitHub account [https://github.com/join]
* Download and install git on your local computer [https://git-scm.com/downloads]
* Set up git on your local computer with your username and email address (link to set up user and email)
* Fork the emfcamp/Mk4-Apps repo (link)
* Clone '''your''' GitHub repo to your computer (link) (maybe mention https://desktop.github.com/ ?)
* Add your app to your local repo (link)
* Create a Pull Request (link)

* Over time, your GitHub report will get out of sync with the changes that have been made to the emfcamp/Mk4-Apps repo so you will need to update your GitHub repo (link)

== Rules for apps in the official badge store ==

* App has to be "Rated G: General Audiences – all ages admitted"
* App should not be of malicious nature
* App complies with EMF's [https://www.emfcamp.org/code-of-conduct Code of Conduct]
* No code/image hot-loading without good reasons (since it might be change after the review process)
* It's fine for people to improve on Apps other have written. Likewise, if you submit an App, be aware that others can and will make changes to it.