README

How to use the default readme

When you create a community app, a README.md file will be created, as a template that can be used to standardize the possible GitHub repositories.

To edit the file you need to know about markdown and how to use it. Check this guide.

The default file

Preview of the README
Header

The logo of the readme is taken from the local files of you repository, in the Images folder.

Below you set the App Name and the Author Name.

Description

Description

Put here a small description of your app, but not every little detail, there will be space for that below.

Badges

Badges

The badges are the most difficult and important part of the readme: since they appear immediately to the eye, it's crucial they are set correctly.

  1. Version Badge: this badge is dynamic, and it syncs automaticaly with the infos of the droptop website. It's important to replace 'Sample%20App' with the name of the actual app on the website. (Instead of spaces you need to use %20) (Example: My%20Beautiful%20App)

  2. Website Badge: static badge for the Droptop website.

  3. Discord Server Badge: static badge for the Discord server.

  4. Downloads Badge: this badge is dynamic, and it syncs automatically with the infos of the repo of the app.

If the Downloads Badge errors, it might be because you hit GitHub's rate limits. You can increase Shields.io's rate limit by adding the Shields GitHub application using your GitHub account.

Table of contents

Table of Contents

You need to add here every header to make users able to navigate to that section faster. You can add, remove and modify the existing ones.

Screenshot

Screenshot

You can embed a screenshot of your app, from the local files of you repository, in the Images folder.

Content

Content

Here you'll put every information regarding your app, from features to licenses. If you add, remove, modify the headers, remember to edit the Table of contents too.

Last updated

Was this helpful?