Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Fastlane Json plugin

fastlane Plugin Badge Gem Version YourActionName Actions Status

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-json, add it to your project by running:

fastlane add_plugin json


This plugin provide several actions that will allow you to manipulate and create json files.


Key Description Env Var Default
json_path Path to json file
verbose verbose false

Read a json file at specific path as a hash object.

Having a json file at path/to/my.json with the following content:

    "name": "Martin",
    "age": 30
my_json = read_json(
    json_path: "path/to/my.json"

puts my_json[:name]
# "Martin"
puts my_json[:age]
# 30


Key Description Env Var Default
json_url Url to json file
verbose verbose false

Downloads a json file from server and convert it to a hash object.

my_json = download_json(
    json_url: ""

puts my_json[:name]
# "Martin Gonzalez"
puts my_json[:gender]
# "male"
puts my_json[:isDev]
# true


Key Description Env Var Default
hash Hash that you want to save as a json file
file_path Path where you want to save your json
verbose verbose false

Creates a json file from a hash.

hash_value = {
      name: "Martin",
      age: 30,
      languages: [

    file_path: "#{__dir__}/my_json.json",
    hash: hash_value

Will create a my_json.json file with the following content:

  "name": "Martin",
  "age": 30,
  "languages": [


Key Description Env Var Default
jsons_paths Array of json files paths
output_path Output path where result will be saved
verbose verbose false

Merges several json files into one hash as output. Also you can set the output_path to save the merged hash into a json file.

Having this files:


  "name": "Martin",
  "age": 30


  "lastName": "Gonzalez",
  "age": 40,
  "isDev": true
output_path = "#{__dir__}/tmp/merged.json"

merged_hash = merge_jsons(
    jsons_paths: [
    output_path: output_path

# {:name=>"Martin", :age=>40, :lastName=>"Gonzalez", :isDev=>true}


Check out the example Fastfile to see how to use this plugin. Try it by cloning the repo, running fastlane install_plugins and bundle exec fastlane all.

Run tests for this plugin

To run both the tests, and code style validation, run


To automatically fix many of the styling issues, use

rubocop -a

Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository.


If you have trouble using plugins, check out the Plugins Troubleshooting guide.

Using fastlane Plugins

For more information about how the fastlane plugin system works, check out the Plugins documentation.

About fastlane

fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out