To contribute to open-source-ios-apps, please edit contents.json instead of the README.

If this seems kind of aggravating, you can always open an issue.

Thanks 😄

A new entry should update contents.json with this format:

Please no emojis in descriptions.

{ "title": "Name of the app", "category-ids": ["category-id"], "tags": ["swift"], "description": "What this app does", "source": "Link to source, usually GitHub", "screenshots": ["http://something.com/image.png"], "license": "mit", "date_added": "Aug 6 2016", "suggested_by": "@github_username" }

Feel free to cut and paste ✂️

Please open an issue.

To delete an app, add the value archive to the tags field (more info).

title, category-ids, description, source, date_added, suggested_by and screenshots are required, the rest is optional.

{ "title": "App name", "category-ids": ["github", "parse"], "description": "Describe what this app does", "source": "https://github.com/user/repo", "homepage": "https://awesome-url", "itunes": "https://itunes.apple.com/app/id1234567890", "license": "mit", "lang": "zho", "stars": 200, "tags": ["swift"], "screenshots": ["http://a.com/image1.png", "http://a.com/image2.png"], "date_added": "Aug 6 2016", "suggested_by": "@github_username" }

• category-ids: List of approved category id (see this list https://github.com/dkhamsing/open-source-ios-apps/wiki/Categories)

• itunes: Link to App Store

  • No regional restriction: the app should not have a region in the URL (/gb below)

    • Good: https://itunes.apple.com/app/gorillas/id302275459
    • Bad: https://itunes.apple.com/gb/app/gorillas/id302275459

  • If the app is only available in a region, the URL should have a region

    • Good: https://itunes.apple.com/gb/app/closebox-find-closest-postbox/id556364813
    • Bad: https://itunes.apple.com/app/closebox-find-closest-postbox/id556364813

• lang: If the app is not in English, use ISO 639-2 language code https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes

• license: Please use the key name from https://developer.github.com/v3/licenses/ (use other if license info missing)

• screenshots: List of links to app images

• stars: Number of GitHub stars

• tags: At the moment, only swift and archive tags are supported