• Start With a Great Readme

  The contents of your project’s readme.md file is what gets shown on glitch.com. Think of it as being like an App Store description, rather than a typical readme on GitHub or elsewhere. This is your spot to get people interested in your project, so it should really sell it.

  Cover what the project does, why it’s useful and what users will need to do to get their own version of the project working (adding in API keys etc.).

  But keep it short — around 100 words total.

• Take the Detail to Setup.md

  If the setup instructions are more than a few lines, then add a setup.md file to your project and use that to go into the detail. Be prescriptive and try not to make too many assumptions. We want projects to be accessible to a wide audience with differing skill levels. So avoid jargon and acronyms whenever possible.

• Don’t Forget the Metadata

  Set your project avatar — it’s a 200x200 file, but they’re often shown at 33x33 and 18x18 on the site and in the app, so they should display well when small.

  Also set your project description and a relevant project title, which also functions as your project’s URL.

• Add a License

  By adding a license to your project people know where they stand — what they can and can’t do with it. We’ve put together some advice if you get stuck, but it doesn’t need to be an arduous thing. In fact, we’ve made the ability to add a license (and a Code of Conduct) to your project a one-click thing in Glitch.

• Comment Your Code

  In-line code explanations are super helpful, so if you have time, then please add them. Also, be sure to remove any extraneous dependencies and unused code.

• Embed a Glitch button

  We’ve made a Glitch button to make it super easy for folks to see who contributed to the project, and move between your app and its code. So, if it’s appropriate to the design of your app feel free to include that too.

• Add a “Remix on Glitch” Button

  Putting a “Remix on Glitch” button on your project’s page makes it super simple for others to get started using Glitch! Click the “Share” button and then click the “Share Buttons” button at the bottom of this menu. You’ll find code there which you can add anywhere, like including it in your docs.

Featured App Requirements

We feature projects on the Glitch homepage, either as a tile or a live embed. In order to be eligible to be featured, there are a few requirements:

• The content of the app should be appropriate for all ages to view.

• There shouldn't be any auto-playing audio, and audio that can't be turned off easily.

• If there's a multi-user element, then a large number of simultaneous shouldn't cause problems like slowness or unresponsiveness of the app.

• If there's an input element, it must not be possible for it to be used to display offensive messages or images.

• To Embed, it also needs to be a responsive app, which displays well on both desktop and mobile.

Yes! You can import your code from GitHub, GitLab, Bitbucket and any other Git repo hosting service.

To do so, select the 'clone-from-repo' option from the 'New Project' drop-down menu under the 'Project Info' menu at the top-left of the editor. Then enter the full HTTPS git web URL and the repo will be cloned. This clone includes all files and the full commit history, which is viewable in Glitch Rewind.

Public repos should work without issue. Private repos require authentication. For GitHub you can log into Glitch with your GitHub account and if necessary, grant rights to import your private repos. For private repos on all other providers, it's possible to use Basic Auth if the provider supports it. The git import url to use would have a format like:

https://user:pass@git-provider.com/orgname/reponame.git

Note that if you're using 2FA then the Basic Auth option might not work unless your hosting provider allows use of an access token instead of your password.

Learn more about the Glitch Help facility.