Home

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 😄

TLDR

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

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

Feel free to cut and paste ✂️

New category

Please open an issue and contact @dkhamsing, @kvnbautista or @scribblemaniac.

Delete app

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

New app (adding a JSON entry)

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