rnv.app Schema Definition
The schema defines the following properties:
id (string)
ID of the app in ./appConfigs/[APP_ID]/renative.json. MUST match APP_ID name of the folder
custom
Object used to extend your renative with custom props. This allows renative json schema to be validated
hidden (boolean)
If set to true in ./appConfigs/[APP_ID]/renative.json the APP_ID will be hidden from list of appConfigs -c
extendsTemplate (string)
You can extend another renative.json file of currently applied template by providing relative or full package name path. Exampe: @rnv/template-starter/renative.json
extend (string)
extend another appConfig by id
common (object)
Common config props used as default props for all available buildSchemes
Properties of the common object:
includedPermissions (array)
Allows you to include specific permissions by their KEY defined in permissions object. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPermissions (array)
Allows you to exclude specific permissions by their KEY defined in permissions object. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
id (string)
Bundle ID of application. ie: com.example.myapp
idSuffix (string)
version (string)
Semver style version of your app
versionCode (string)
Manual verride of generated version code
versionFormat (string)
Allows you to fine-tune app version defined in package.json or renative.json. If you do not define versionFormat, no formatting will apply to version.
versionCodeFormat (string)
Allows you to fine-tune auto generated version codes. Version code is autogenerated from app version defined in package.json or renative.json.
versionCodeOffset (number)
title (string)
Title of your app will be used to create title of the binary. ie App title of installed app iOS/Android app or Tab title of the website
description (string)
General description of your app. This prop will be injected to actual projects where description field is applicable
author (string)
Author name
license (string)
Injects license information into app
includedFonts (array)
Array of fonts you want to include in specific app or scheme. Should use exact font file (without the extension) located in ./appConfigs/base/fonts or * to mark all
The object is an array with all elements of the type string.
backgroundColor (string)
Defines root view backgroundColor for all platforms in HEX format
Constraints:
- Regex pattern:
^#
splashScreen (boolean)
Enable or disable splash screen
fontSources (array)
Array of paths to location of external Fonts. you can use resolve function here example: {{resolvePackage(react-native-vector-icons)}}/Fonts
The object is an array with all elements of the type string.
assetSources (array)
Array of paths to alternative external assets. this will take priority over ./appConfigs/base/assets folder on your local project. You can use resolve function here example: {{resolvePackage(@flexn/template-starter)}}/appConfigs/base/assets
The object is an array with all elements of the type string.
includedPlugins (array)
Defines an array of all included plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: includedPlugins is evaluated before excludedPlugins. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPlugins (array)
Defines an array of all excluded plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: excludedPlugins is evaluated after includedPlugins. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
runtime
This object will be automatically injected into ./platfromAssets/renative.runtime.json making it possible to inject the values directly to JS source code
custom
Object used to extend your renative with custom props. This allows renative json schema to be validated
buildSchemes (object)
Properties of the buildSchemes object:
includedPermissions (array)
Allows you to include specific permissions by their KEY defined in permissions object. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPermissions (array)
Allows you to exclude specific permissions by their KEY defined in permissions object. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
id (string)
Bundle ID of application. ie: com.example.myapp
idSuffix (string)
version (string)
Semver style version of your app
versionCode (string)
Manual verride of generated version code
versionFormat (string)
Allows you to fine-tune app version defined in package.json or renative.json. If you do not define versionFormat, no formatting will apply to version.
versionCodeFormat (string)
Allows you to fine-tune auto generated version codes. Version code is autogenerated from app version defined in package.json or renative.json.
versionCodeOffset (number)
title (string)
Title of your app will be used to create title of the binary. ie App title of installed app iOS/Android app or Tab title of the website
description (string)
Custom description of the buildScheme will be displayed directly in cli if you run rnv with an empty paramener -s
author (string)
Author name
license (string)
Injects license information into app
includedFonts (array)
Array of fonts you want to include in specific app or scheme. Should use exact font file (without the extension) located in ./appConfigs/base/fonts or * to mark all
The object is an array with all elements of the type string.
backgroundColor (string)
Defines root view backgroundColor for all platforms in HEX format
Constraints:
- Regex pattern:
^#
splashScreen (boolean)
Enable or disable splash screen
fontSources (array)
Array of paths to location of external Fonts. you can use resolve function here example: {{resolvePackage(react-native-vector-icons)}}/Fonts
The object is an array with all elements of the type string.
assetSources (array)
Array of paths to alternative external assets. this will take priority over ./appConfigs/base/assets folder on your local project. You can use resolve function here example: {{resolvePackage(@flexn/template-starter)}}/appConfigs/base/assets
The object is an array with all elements of the type string.
includedPlugins (array)
Defines an array of all included plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: includedPlugins is evaluated before excludedPlugins. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPlugins (array)
Defines an array of all excluded plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: excludedPlugins is evaluated after includedPlugins. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
runtime
This object will be automatically injected into ./platfromAssets/renative.runtime.json making it possible to inject the values directly to JS source code
custom
Object used to extend your renative with custom props. This allows renative json schema to be validated
enabled (boolean)
Defines whether build scheme shows up in options to run
extendPlatform (string, enum)
This element must be one of the following enum values:
webiosandroidandroidtvfiretvtvosmacoslinuxwindowstizenweboschromecastkaioswebtvandroidweartizenwatchtizenmobilexbox
assetFolderPlatform (string)
Alternative platform assets. This is useful for example when you want to use same android assets in androidtv and want to avoid duplicating assets
engine (string)
ID of engine to be used for this platform. Note: engine must be registered in engines field
entryFile (string)
Alternative name of the entry file without .js extension
Default: "index"
bundleAssets (boolean)
If set to true compiled js bundle file will generated. this is needed if you want to make production like builds
enableSourceMaps (boolean)
If set to true dedicated source map file will be generated alongside of compiled js bundle
bundleIsDev (boolean)
If set to true debug build will be generated
getJsBundleFile (string)
platforms (object)
Object containing platform configurations
Properties of the platforms object:
android (object)
Properties of the android object:
buildSchemes (object)
Properties of the buildSchemes object:
includedPermissions (array)
Allows you to include specific permissions by their KEY defined in permissions object. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPermissions (array)
Allows you to exclude specific permissions by their KEY defined in permissions object. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
id (string)
Bundle ID of application. ie: com.example.myapp
idSuffix (string)
version (string)
Semver style version of your app
versionCode (string)
Manual verride of generated version code
versionFormat (string)
Allows you to fine-tune app version defined in package.json or renative.json. If you do not define versionFormat, no formatting will apply to version.
versionCodeFormat (string)
Allows you to fine-tune auto generated version codes. Version code is autogenerated from app version defined in package.json or renative.json.
versionCodeOffset (number)
title (string)
Title of your app will be used to create title of the binary. ie App title of installed app iOS/Android app or Tab title of the website
description (string)
General description of your app. This prop will be injected to actual projects where description field is applicable
author (string)
Author name
license (string)
Injects license information into app
includedFonts (array)
Array of fonts you want to include in specific app or scheme. Should use exact font file (without the extension) located in ./appConfigs/base/fonts or * to mark all
The object is an array with all elements of the type string.
backgroundColor (string)
Defines root view backgroundColor for all platforms in HEX format
Constraints:
- Regex pattern:
^#
splashScreen (boolean)
Enable or disable splash screen
fontSources (array)
Array of paths to location of external Fonts. you can use resolve function here example: {{resolvePackage(react-native-vector-icons)}}/Fonts
The object is an array with all elements of the type string.
assetSources (array)
Array of paths to alternative external assets. this will take priority over ./appConfigs/base/assets folder on your local project. You can use resolve function here example: {{resolvePackage(@flexn/template-starter)}}/appConfigs/base/assets
The object is an array with all elements of the type string.
includedPlugins (array)
Defines an array of all included plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: includedPlugins is evaluated before excludedPlugins. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPlugins (array)
Defines an array of all excluded plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: excludedPlugins is evaluated after includedPlugins. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
runtime
This object will be automatically injected into ./platfromAssets/renative.runtime.json making it possible to inject the values directly to JS source code
custom
Object used to extend your renative with custom props. This allows renative json schema to be validated
extendPlatform (string, enum)
This element must be one of the following enum values:
webiosandroidandroidtvfiretvtvosmacoslinuxwindowstizenweboschromecastkaioswebtvandroidweartizenwatchtizenmobilexbox
assetFolderPlatform (string)
Alternative platform assets. This is useful for example when you want to use same android assets in androidtv and want to avoid duplicating assets
engine (string)
ID of engine to be used for this platform. Note: engine must be registered in engines field
entryFile (string)
Alternative name of the entry file without .js extension
Default: "index"
bundleAssets (boolean)
If set to true compiled js bundle file will generated. this is needed if you want to make production like builds
enableSourceMaps (boolean)
If set to true dedicated source map file will be generated alongside of compiled js bundle
bundleIsDev (boolean)
If set to true debug build will be generated
getJsBundleFile (string)
enableAndroidX (boolean,string)
Enables new android X architecture
Default: true
enableJetifier (boolean,string)
Enables Jetifier
Default: true
signingConfig (string)
Equivalent to running ./gradlew/assembleDebug or ./gradlew/assembleRelease
Default: "Debug"
minSdkVersion (number)
Minimum Android SDK version device has to have in order for app to run
Default: 28
multipleAPKs (boolean)
If set to true, apk will be split into multiple ones for each architecture: "armeabi-v7a", "x86", "arm64-v8a", "x86_64"
aab (boolean)
If set to true, android project will generate app.aab instead of apk
extraGradleParams (string)
Allows passing extra params to gradle command
minifyEnabled (boolean)
Sets minifyEnabled buildType property in app/build.gradle
targetSdkVersion (number)
Allows you define custom targetSdkVersion equivalent to: targetSdkVersion = [VERSION] in build.gradle
compileSdkVersion (number)
Allows you define custom compileSdkVersion equivalent to: compileSdkVersion = [VERSION] in build.gradle
kotlinVersion (string)
Allows you define custom kotlin version
Default: "1.7.10"
ndkVersion (string)
Allows you define custom ndkVersion equivalent to: ndkVersion = [VERSION] in build.gradle
supportLibVersion (string)
Allows you define custom supportLibVersion equivalent to: supportLibVersion = [VERSION] in build.gradle
googleServicesVersion (string)
Allows you define custom googleServicesVersion equivalent to: googleServicesVersion = [VERSION] in build.gradle
gradleBuildToolsVersion (string)
Allows you define custom gradle build tools version equivalent to: classpath 'com.android.tools.build:gradle:[VERSION]'
gradleWrapperVersion (string)
Allows you define custom gradle wrapper version equivalent to: distributionUrl=https\://services.gradle.org/distributions/gradle-[VERSION]-all.zip
excludedFeatures (array)
Override features definitions in AndroidManifest.xml by exclusion
The object is an array with all elements of the type string.
includedFeatures (array)
Override features definitions in AndroidManifest.xml by inclusion
The object is an array with all elements of the type string.
buildToolsVersion (string)
Override android build tools version
Default: "34.0.0"
disableSigning (boolean)
storeFile (string)
Name of the store file in android project
keyAlias (string)
Key alias of the store file in android project
newArchEnabled (boolean)
Enables new arch for android. Default: false
flipperEnabled (boolean)
Enables flipper for ios. Default: true
reactNativeEngine (string, enum)
Allows you to define specific native render engine to be used
This element must be one of the following enum values:
jscv8-androidv8-android-nointlv8-android-jitv8-android-jit-nointlhermes
Default: "hermes"
templateAndroid (object)
Properties of the templateAndroid object:
gradle_properties (object)
Overrides values in gradle.properties file of generated android based project
build_gradle (object)
Overrides values in build.gradle file of generated android based project
Properties of the build_gradle object:
plugins (array)
The object is an array with all elements of the type string.
buildscript (object)
Properties of the buildscript object:
repositories (array, required)
The object is an array with all elements of the type string.
dependencies (array, required)
The object is an array with all elements of the type string.
ext (array, required)
The object is an array with all elements of the type string.
custom (array, required)
The object is an array with all elements of the type string.
injectAfterAll (array)
The object is an array with all elements of the type string.
app_build_gradle (object)
Overrides values in app/build.gradle file of generated android based project
Properties of the app_build_gradle object:
apply (array)
The object is an array with all elements of the type string.
defaultConfig (array)
The object is an array with all elements of the type string.
buildTypes (object)
Properties of the buildTypes object:
debug (array)
The object is an array with all elements of the type string.
release (array)
The object is an array with all elements of the type string.
afterEvaluate (array)
The object is an array with all elements of the type string.
implementations (array)
The object is an array with all elements of the type string.
implementation (string)
AndroidManifest_xml (object)
Allows you to directly manipulate AndroidManifest.xml via json override mechanism
Injects / Overrides values in AndroidManifest.xml file of generated android based project
IMPORTANT: always ensure that your object contains
tagandandroid:nameto target correct tag to merge into
Properties of the AndroidManifest_xml object:
tag (string, required)
package (string)
xmlns:android (string)
xmlns:tools (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
android:name (string)
android:theme (string)
android:value
android:required (boolean)
android:allowBackup (boolean)
android:largeHeap (boolean)
android:label (string)
android:icon (string)
android:roundIcon (string)
android:banner (string)
tools:replace (string)
android:supportsRtl (boolean)
tools:targetApi (number)
android:usesCleartextTraffic (boolean)
android:appComponentFactory (string)
android:screenOrientation (string)
android:noHistory (boolean)
android:launchMode (string)
android:exported (boolean)
android:configChanges (string)
android:windowSoftInputMode (string)
children (array)
strings_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the strings_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
styles_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the styles_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
colors_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the colors_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
MainApplication_kt (object)
Allows you to configure behaviour of MainActivity
Properties of the MainApplication_kt object:
imports (array)
The object is an array with all elements of the type string.
methods (array)
The object is an array with all elements of the type string.
createMethods (array)
The object is an array with all elements of the type string.
packages (array)
The object is an array with all elements of the type string.
packageParams (array)
The object is an array with all elements of the type string.
MainActivity_kt (object)
Properties of the MainActivity_kt object:
onCreate (string)
Overrides super.onCreate method handler of MainActivity.kt
Default: "super.onCreate(savedInstanceState)"
imports (array)
The object is an array with all elements of the type string.
methods (array)
The object is an array with all elements of the type string.
createMethods (array)
The object is an array with all elements of the type string.
resultMethods (array)
The object is an array with all elements of the type string.
SplashActivity_kt (object)
Properties of the SplashActivity_kt object:
settings_gradle (object)
Properties of the settings_gradle object:
include (array, required)
The object is an array with all elements of the type string.
project (array, required)
The object is an array with all elements of the type string.
gradle_wrapper_properties (object)
Properties of the gradle_wrapper_properties object:
proguard_rules_pro (object)
Properties of the proguard_rules_pro object:
includedPermissions (array)
Allows you to include specific permissions by their KEY defined in permissions object. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPermissions (array)
Allows you to exclude specific permissions by their KEY defined in permissions object. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
id (string)
Bundle ID of application. ie: com.example.myapp
idSuffix (string)
version (string)
Semver style version of your app
versionCode (string)
Manual verride of generated version code
versionFormat (string)
Allows you to fine-tune app version defined in package.json or renative.json. If you do not define versionFormat, no formatting will apply to version.
versionCodeFormat (string)
Allows you to fine-tune auto generated version codes. Version code is autogenerated from app version defined in package.json or renative.json.
versionCodeOffset (number)
title (string)
Title of your app will be used to create title of the binary. ie App title of installed app iOS/Android app or Tab title of the website
description (string)
General description of your app. This prop will be injected to actual projects where description field is applicable
author (string)
Author name
license (string)
Injects license information into app
includedFonts (array)
Array of fonts you want to include in specific app or scheme. Should use exact font file (without the extension) located in ./appConfigs/base/fonts or * to mark all
The object is an array with all elements of the type string.
backgroundColor (string)
Defines root view backgroundColor for all platforms in HEX format
Constraints:
- Regex pattern:
^#
splashScreen (boolean)
Enable or disable splash screen
fontSources (array)
Array of paths to location of external Fonts. you can use resolve function here example: {{resolvePackage(react-native-vector-icons)}}/Fonts
The object is an array with all elements of the type string.
assetSources (array)
Array of paths to alternative external assets. this will take priority over ./appConfigs/base/assets folder on your local project. You can use resolve function here example: {{resolvePackage(@flexn/template-starter)}}/appConfigs/base/assets
The object is an array with all elements of the type string.
includedPlugins (array)
Defines an array of all included plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: includedPlugins is evaluated before excludedPlugins. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPlugins (array)
Defines an array of all excluded plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: excludedPlugins is evaluated after includedPlugins. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
runtime
This object will be automatically injected into ./platfromAssets/renative.runtime.json making it possible to inject the values directly to JS source code
custom
Object used to extend your renative with custom props. This allows renative json schema to be validated
extendPlatform (string, enum)
This element must be one of the following enum values:
webiosandroidandroidtvfiretvtvosmacoslinuxwindowstizenweboschromecastkaioswebtvandroidweartizenwatchtizenmobilexbox
assetFolderPlatform (string)
Alternative platform assets. This is useful for example when you want to use same android assets in androidtv and want to avoid duplicating assets
engine (string)
ID of engine to be used for this platform. Note: engine must be registered in engines field
entryFile (string)
Alternative name of the entry file without .js extension
Default: "index"
bundleAssets (boolean)
If set to true compiled js bundle file will generated. this is needed if you want to make production like builds
enableSourceMaps (boolean)
If set to true dedicated source map file will be generated alongside of compiled js bundle
bundleIsDev (boolean)
If set to true debug build will be generated
getJsBundleFile (string)
enableAndroidX (boolean,string)
Enables new android X architecture
Default: true
enableJetifier (boolean,string)
Enables Jetifier
Default: true
signingConfig (string)
Equivalent to running ./gradlew/assembleDebug or ./gradlew/assembleRelease
Default: "Debug"
minSdkVersion (number)
Minimum Android SDK version device has to have in order for app to run
Default: 28
multipleAPKs (boolean)
If set to true, apk will be split into multiple ones for each architecture: "armeabi-v7a", "x86", "arm64-v8a", "x86_64"
aab (boolean)
If set to true, android project will generate app.aab instead of apk
extraGradleParams (string)
Allows passing extra params to gradle command
minifyEnabled (boolean)
Sets minifyEnabled buildType property in app/build.gradle
targetSdkVersion (number)
Allows you define custom targetSdkVersion equivalent to: targetSdkVersion = [VERSION] in build.gradle
compileSdkVersion (number)
Allows you define custom compileSdkVersion equivalent to: compileSdkVersion = [VERSION] in build.gradle
kotlinVersion (string)
Allows you define custom kotlin version
Default: "1.7.10"
ndkVersion (string)
Allows you define custom ndkVersion equivalent to: ndkVersion = [VERSION] in build.gradle
supportLibVersion (string)
Allows you define custom supportLibVersion equivalent to: supportLibVersion = [VERSION] in build.gradle
googleServicesVersion (string)
Allows you define custom googleServicesVersion equivalent to: googleServicesVersion = [VERSION] in build.gradle
gradleBuildToolsVersion (string)
Allows you define custom gradle build tools version equivalent to: classpath 'com.android.tools.build:gradle:[VERSION]'
gradleWrapperVersion (string)
Allows you define custom gradle wrapper version equivalent to: distributionUrl=https\://services.gradle.org/distributions/gradle-[VERSION]-all.zip
excludedFeatures (array)
Override features definitions in AndroidManifest.xml by exclusion
The object is an array with all elements of the type string.
includedFeatures (array)
Override features definitions in AndroidManifest.xml by inclusion
The object is an array with all elements of the type string.
buildToolsVersion (string)
Override android build tools version
Default: "34.0.0"
disableSigning (boolean)
storeFile (string)
Name of the store file in android project
keyAlias (string)
Key alias of the store file in android project
newArchEnabled (boolean)
Enables new arch for android. Default: false
flipperEnabled (boolean)
Enables flipper for ios. Default: true
reactNativeEngine (string, enum)
Allows you to define specific native render engine to be used
This element must be one of the following enum values:
jscv8-androidv8-android-nointlv8-android-jitv8-android-jit-nointlhermes
Default: "hermes"
templateAndroid (object)
Properties of the templateAndroid object:
gradle_properties (object)
Overrides values in gradle.properties file of generated android based project
build_gradle (object)
Overrides values in build.gradle file of generated android based project
Properties of the build_gradle object:
plugins (array)
The object is an array with all elements of the type string.
buildscript (object)
Properties of the buildscript object:
repositories (array, required)
The object is an array with all elements of the type string.
dependencies (array, required)
The object is an array with all elements of the type string.
ext (array, required)
The object is an array with all elements of the type string.
custom (array, required)
The object is an array with all elements of the type string.
injectAfterAll (array)
The object is an array with all elements of the type string.
app_build_gradle (object)
Overrides values in app/build.gradle file of generated android based project
Properties of the app_build_gradle object:
apply (array)
The object is an array with all elements of the type string.
defaultConfig (array)
The object is an array with all elements of the type string.
buildTypes (object)
Properties of the buildTypes object:
debug (array)
The object is an array with all elements of the type string.
release (array)
The object is an array with all elements of the type string.
afterEvaluate (array)
The object is an array with all elements of the type string.
implementations (array)
The object is an array with all elements of the type string.
implementation (string)
AndroidManifest_xml (object)
Allows you to directly manipulate AndroidManifest.xml via json override mechanism
Injects / Overrides values in AndroidManifest.xml file of generated android based project
IMPORTANT: always ensure that your object contains
tagandandroid:nameto target correct tag to merge into
Properties of the AndroidManifest_xml object:
tag (string, required)
package (string)
xmlns:android (string)
xmlns:tools (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
android:name (string)
android:theme (string)
android:value
android:required (boolean)
android:allowBackup (boolean)
android:largeHeap (boolean)
android:label (string)
android:icon (string)
android:roundIcon (string)
android:banner (string)
tools:replace (string)
android:supportsRtl (boolean)
tools:targetApi (number)
android:usesCleartextTraffic (boolean)
android:appComponentFactory (string)
android:screenOrientation (string)
android:noHistory (boolean)
android:launchMode (string)
android:exported (boolean)
android:configChanges (string)
android:windowSoftInputMode (string)
children (array)
strings_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the strings_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
styles_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the styles_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
colors_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the colors_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
MainApplication_kt (object)
Allows you to configure behaviour of MainActivity
Properties of the MainApplication_kt object:
imports (array)
The object is an array with all elements of the type string.
methods (array)
The object is an array with all elements of the type string.
createMethods (array)
The object is an array with all elements of the type string.
packages (array)
The object is an array with all elements of the type string.
packageParams (array)
The object is an array with all elements of the type string.
MainActivity_kt (object)
Properties of the MainActivity_kt object:
onCreate (string)
Overrides super.onCreate method handler of MainActivity.kt
Default: "super.onCreate(savedInstanceState)"
imports (array)
The object is an array with all elements of the type string.
methods (array)
The object is an array with all elements of the type string.
createMethods (array)
The object is an array with all elements of the type string.
resultMethods (array)
The object is an array with all elements of the type string.
SplashActivity_kt (object)
Properties of the SplashActivity_kt object:
settings_gradle (object)
Properties of the settings_gradle object:
include (array, required)
The object is an array with all elements of the type string.
project (array, required)
The object is an array with all elements of the type string.
gradle_wrapper_properties (object)
Properties of the gradle_wrapper_properties object:
proguard_rules_pro (object)
Properties of the proguard_rules_pro object:
androidtv (object)
Properties of the androidtv object:
buildSchemes (object)
Properties of the buildSchemes object:
includedPermissions (array)
Allows you to include specific permissions by their KEY defined in permissions object. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPermissions (array)
Allows you to exclude specific permissions by their KEY defined in permissions object. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
id (string)
Bundle ID of application. ie: com.example.myapp
idSuffix (string)
version (string)
Semver style version of your app
versionCode (string)
Manual verride of generated version code
versionFormat (string)
Allows you to fine-tune app version defined in package.json or renative.json. If you do not define versionFormat, no formatting will apply to version.
versionCodeFormat (string)
Allows you to fine-tune auto generated version codes. Version code is autogenerated from app version defined in package.json or renative.json.
versionCodeOffset (number)
title (string)
Title of your app will be used to create title of the binary. ie App title of installed app iOS/Android app or Tab title of the website
description (string)
General description of your app. This prop will be injected to actual projects where description field is applicable
author (string)
Author name
license (string)
Injects license information into app
includedFonts (array)
Array of fonts you want to include in specific app or scheme. Should use exact font file (without the extension) located in ./appConfigs/base/fonts or * to mark all
The object is an array with all elements of the type string.
backgroundColor (string)
Defines root view backgroundColor for all platforms in HEX format
Constraints:
- Regex pattern:
^#
splashScreen (boolean)
Enable or disable splash screen
fontSources (array)
Array of paths to location of external Fonts. you can use resolve function here example: {{resolvePackage(react-native-vector-icons)}}/Fonts
The object is an array with all elements of the type string.
assetSources (array)
Array of paths to alternative external assets. this will take priority over ./appConfigs/base/assets folder on your local project. You can use resolve function here example: {{resolvePackage(@flexn/template-starter)}}/appConfigs/base/assets
The object is an array with all elements of the type string.
includedPlugins (array)
Defines an array of all included plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: includedPlugins is evaluated before excludedPlugins. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPlugins (array)
Defines an array of all excluded plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: excludedPlugins is evaluated after includedPlugins. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
runtime
This object will be automatically injected into ./platfromAssets/renative.runtime.json making it possible to inject the values directly to JS source code
custom
Object used to extend your renative with custom props. This allows renative json schema to be validated
extendPlatform (string, enum)
This element must be one of the following enum values:
webiosandroidandroidtvfiretvtvosmacoslinuxwindowstizenweboschromecastkaioswebtvandroidweartizenwatchtizenmobilexbox
assetFolderPlatform (string)
Alternative platform assets. This is useful for example when you want to use same android assets in androidtv and want to avoid duplicating assets
engine (string)
ID of engine to be used for this platform. Note: engine must be registered in engines field
entryFile (string)
Alternative name of the entry file without .js extension
Default: "index"
bundleAssets (boolean)
If set to true compiled js bundle file will generated. this is needed if you want to make production like builds
enableSourceMaps (boolean)
If set to true dedicated source map file will be generated alongside of compiled js bundle
bundleIsDev (boolean)
If set to true debug build will be generated
getJsBundleFile (string)
enableAndroidX (boolean,string)
Enables new android X architecture
Default: true
enableJetifier (boolean,string)
Enables Jetifier
Default: true
signingConfig (string)
Equivalent to running ./gradlew/assembleDebug or ./gradlew/assembleRelease
Default: "Debug"
minSdkVersion (number)
Minimum Android SDK version device has to have in order for app to run
Default: 28
multipleAPKs (boolean)
If set to true, apk will be split into multiple ones for each architecture: "armeabi-v7a", "x86", "arm64-v8a", "x86_64"
aab (boolean)
If set to true, android project will generate app.aab instead of apk
extraGradleParams (string)
Allows passing extra params to gradle command
minifyEnabled (boolean)
Sets minifyEnabled buildType property in app/build.gradle
targetSdkVersion (number)
Allows you define custom targetSdkVersion equivalent to: targetSdkVersion = [VERSION] in build.gradle
compileSdkVersion (number)
Allows you define custom compileSdkVersion equivalent to: compileSdkVersion = [VERSION] in build.gradle
kotlinVersion (string)
Allows you define custom kotlin version
Default: "1.7.10"
ndkVersion (string)
Allows you define custom ndkVersion equivalent to: ndkVersion = [VERSION] in build.gradle
supportLibVersion (string)
Allows you define custom supportLibVersion equivalent to: supportLibVersion = [VERSION] in build.gradle
googleServicesVersion (string)
Allows you define custom googleServicesVersion equivalent to: googleServicesVersion = [VERSION] in build.gradle
gradleBuildToolsVersion (string)
Allows you define custom gradle build tools version equivalent to: classpath 'com.android.tools.build:gradle:[VERSION]'
gradleWrapperVersion (string)
Allows you define custom gradle wrapper version equivalent to: distributionUrl=https\://services.gradle.org/distributions/gradle-[VERSION]-all.zip
excludedFeatures (array)
Override features definitions in AndroidManifest.xml by exclusion
The object is an array with all elements of the type string.
includedFeatures (array)
Override features definitions in AndroidManifest.xml by inclusion
The object is an array with all elements of the type string.
buildToolsVersion (string)
Override android build tools version
Default: "34.0.0"
disableSigning (boolean)
storeFile (string)
Name of the store file in android project
keyAlias (string)
Key alias of the store file in android project
newArchEnabled (boolean)
Enables new arch for android. Default: false
flipperEnabled (boolean)
Enables flipper for ios. Default: true
reactNativeEngine (string, enum)
Allows you to define specific native render engine to be used
This element must be one of the following enum values:
jscv8-androidv8-android-nointlv8-android-jitv8-android-jit-nointlhermes
Default: "hermes"
templateAndroid (object)
Properties of the templateAndroid object:
gradle_properties (object)
Overrides values in gradle.properties file of generated android based project
build_gradle (object)
Overrides values in build.gradle file of generated android based project
Properties of the build_gradle object:
plugins (array)
The object is an array with all elements of the type string.
buildscript (object)
Properties of the buildscript object:
repositories (array, required)
The object is an array with all elements of the type string.
dependencies (array, required)
The object is an array with all elements of the type string.
ext (array, required)
The object is an array with all elements of the type string.
custom (array, required)
The object is an array with all elements of the type string.
injectAfterAll (array)
The object is an array with all elements of the type string.
app_build_gradle (object)
Overrides values in app/build.gradle file of generated android based project
Properties of the app_build_gradle object:
apply (array)
The object is an array with all elements of the type string.
defaultConfig (array)
The object is an array with all elements of the type string.
buildTypes (object)
Properties of the buildTypes object:
debug (array)
The object is an array with all elements of the type string.
release (array)
The object is an array with all elements of the type string.
afterEvaluate (array)
The object is an array with all elements of the type string.
implementations (array)
The object is an array with all elements of the type string.
implementation (string)
AndroidManifest_xml (object)
Allows you to directly manipulate AndroidManifest.xml via json override mechanism
Injects / Overrides values in AndroidManifest.xml file of generated android based project
IMPORTANT: always ensure that your object contains
tagandandroid:nameto target correct tag to merge into
Properties of the AndroidManifest_xml object:
tag (string, required)
package (string)
xmlns:android (string)
xmlns:tools (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
android:name (string)
android:theme (string)
android:value
android:required (boolean)
android:allowBackup (boolean)
android:largeHeap (boolean)
android:label (string)
android:icon (string)
android:roundIcon (string)
android:banner (string)
tools:replace (string)
android:supportsRtl (boolean)
tools:targetApi (number)
android:usesCleartextTraffic (boolean)
android:appComponentFactory (string)
android:screenOrientation (string)
android:noHistory (boolean)
android:launchMode (string)
android:exported (boolean)
android:configChanges (string)
android:windowSoftInputMode (string)
children (array)
strings_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the strings_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
styles_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the styles_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
colors_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the colors_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
MainApplication_kt (object)
Allows you to configure behaviour of MainActivity
Properties of the MainApplication_kt object:
imports (array)
The object is an array with all elements of the type string.
methods (array)
The object is an array with all elements of the type string.
createMethods (array)
The object is an array with all elements of the type string.
packages (array)
The object is an array with all elements of the type string.
packageParams (array)
The object is an array with all elements of the type string.
MainActivity_kt (object)
Properties of the MainActivity_kt object:
onCreate (string)
Overrides super.onCreate method handler of MainActivity.kt
Default: "super.onCreate(savedInstanceState)"
imports (array)
The object is an array with all elements of the type string.
methods (array)
The object is an array with all elements of the type string.
createMethods (array)
The object is an array with all elements of the type string.
resultMethods (array)
The object is an array with all elements of the type string.
SplashActivity_kt (object)
Properties of the SplashActivity_kt object:
settings_gradle (object)
Properties of the settings_gradle object:
include (array, required)
The object is an array with all elements of the type string.
project (array, required)
The object is an array with all elements of the type string.
gradle_wrapper_properties (object)
Properties of the gradle_wrapper_properties object:
proguard_rules_pro (object)
Properties of the proguard_rules_pro object:
includedPermissions (array)
Allows you to include specific permissions by their KEY defined in permissions object. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPermissions (array)
Allows you to exclude specific permissions by their KEY defined in permissions object. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
id (string)
Bundle ID of application. ie: com.example.myapp
idSuffix (string)
version (string)
Semver style version of your app
versionCode (string)
Manual verride of generated version code
versionFormat (string)
Allows you to fine-tune app version defined in package.json or renative.json. If you do not define versionFormat, no formatting will apply to version.
versionCodeFormat (string)
Allows you to fine-tune auto generated version codes. Version code is autogenerated from app version defined in package.json or renative.json.
versionCodeOffset (number)
title (string)
Title of your app will be used to create title of the binary. ie App title of installed app iOS/Android app or Tab title of the website
description (string)
General description of your app. This prop will be injected to actual projects where description field is applicable
author (string)
Author name
license (string)
Injects license information into app
includedFonts (array)
Array of fonts you want to include in specific app or scheme. Should use exact font file (without the extension) located in ./appConfigs/base/fonts or * to mark all
The object is an array with all elements of the type string.
backgroundColor (string)
Defines root view backgroundColor for all platforms in HEX format
Constraints:
- Regex pattern:
^#
splashScreen (boolean)
Enable or disable splash screen
fontSources (array)
Array of paths to location of external Fonts. you can use resolve function here example: {{resolvePackage(react-native-vector-icons)}}/Fonts
The object is an array with all elements of the type string.
assetSources (array)
Array of paths to alternative external assets. this will take priority over ./appConfigs/base/assets folder on your local project. You can use resolve function here example: {{resolvePackage(@flexn/template-starter)}}/appConfigs/base/assets
The object is an array with all elements of the type string.
includedPlugins (array)
Defines an array of all included plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: includedPlugins is evaluated before excludedPlugins. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPlugins (array)
Defines an array of all excluded plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: excludedPlugins is evaluated after includedPlugins. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
runtime
This object will be automatically injected into ./platfromAssets/renative.runtime.json making it possible to inject the values directly to JS source code
custom
Object used to extend your renative with custom props. This allows renative json schema to be validated
extendPlatform (string, enum)
This element must be one of the following enum values:
webiosandroidandroidtvfiretvtvosmacoslinuxwindowstizenweboschromecastkaioswebtvandroidweartizenwatchtizenmobilexbox
assetFolderPlatform (string)
Alternative platform assets. This is useful for example when you want to use same android assets in androidtv and want to avoid duplicating assets
engine (string)
ID of engine to be used for this platform. Note: engine must be registered in engines field
entryFile (string)
Alternative name of the entry file without .js extension
Default: "index"
bundleAssets (boolean)
If set to true compiled js bundle file will generated. this is needed if you want to make production like builds
enableSourceMaps (boolean)
If set to true dedicated source map file will be generated alongside of compiled js bundle
bundleIsDev (boolean)
If set to true debug build will be generated
getJsBundleFile (string)
enableAndroidX (boolean,string)
Enables new android X architecture
Default: true
enableJetifier (boolean,string)
Enables Jetifier
Default: true
signingConfig (string)
Equivalent to running ./gradlew/assembleDebug or ./gradlew/assembleRelease
Default: "Debug"
minSdkVersion (number)
Minimum Android SDK version device has to have in order for app to run
Default: 28
multipleAPKs (boolean)
If set to true, apk will be split into multiple ones for each architecture: "armeabi-v7a", "x86", "arm64-v8a", "x86_64"
aab (boolean)
If set to true, android project will generate app.aab instead of apk
extraGradleParams (string)
Allows passing extra params to gradle command
minifyEnabled (boolean)
Sets minifyEnabled buildType property in app/build.gradle
targetSdkVersion (number)
Allows you define custom targetSdkVersion equivalent to: targetSdkVersion = [VERSION] in build.gradle
compileSdkVersion (number)
Allows you define custom compileSdkVersion equivalent to: compileSdkVersion = [VERSION] in build.gradle
kotlinVersion (string)
Allows you define custom kotlin version
Default: "1.7.10"
ndkVersion (string)
Allows you define custom ndkVersion equivalent to: ndkVersion = [VERSION] in build.gradle
supportLibVersion (string)
Allows you define custom supportLibVersion equivalent to: supportLibVersion = [VERSION] in build.gradle
googleServicesVersion (string)
Allows you define custom googleServicesVersion equivalent to: googleServicesVersion = [VERSION] in build.gradle
gradleBuildToolsVersion (string)
Allows you define custom gradle build tools version equivalent to: classpath 'com.android.tools.build:gradle:[VERSION]'
gradleWrapperVersion (string)
Allows you define custom gradle wrapper version equivalent to: distributionUrl=https\://services.gradle.org/distributions/gradle-[VERSION]-all.zip
excludedFeatures (array)
Override features definitions in AndroidManifest.xml by exclusion
The object is an array with all elements of the type string.
includedFeatures (array)
Override features definitions in AndroidManifest.xml by inclusion
The object is an array with all elements of the type string.
buildToolsVersion (string)
Override android build tools version
Default: "34.0.0"
disableSigning (boolean)
storeFile (string)
Name of the store file in android project
keyAlias (string)
Key alias of the store file in android project
newArchEnabled (boolean)
Enables new arch for android. Default: false
flipperEnabled (boolean)
Enables flipper for ios. Default: true
reactNativeEngine (string, enum)
Allows you to define specific native render engine to be used
This element must be one of the following enum values:
jscv8-androidv8-android-nointlv8-android-jitv8-android-jit-nointlhermes
Default: "hermes"
templateAndroid (object)
Properties of the templateAndroid object:
gradle_properties (object)
Overrides values in gradle.properties file of generated android based project
build_gradle (object)
Overrides values in build.gradle file of generated android based project
Properties of the build_gradle object:
plugins (array)
The object is an array with all elements of the type string.
buildscript (object)
Properties of the buildscript object:
repositories (array, required)
The object is an array with all elements of the type string.
dependencies (array, required)
The object is an array with all elements of the type string.
ext (array, required)
The object is an array with all elements of the type string.
custom (array, required)
The object is an array with all elements of the type string.
injectAfterAll (array)
The object is an array with all elements of the type string.
app_build_gradle (object)
Overrides values in app/build.gradle file of generated android based project
Properties of the app_build_gradle object:
apply (array)
The object is an array with all elements of the type string.
defaultConfig (array)
The object is an array with all elements of the type string.
buildTypes (object)
Properties of the buildTypes object:
debug (array)
The object is an array with all elements of the type string.
release (array)
The object is an array with all elements of the type string.
afterEvaluate (array)
The object is an array with all elements of the type string.
implementations (array)
The object is an array with all elements of the type string.
implementation (string)
AndroidManifest_xml (object)
Allows you to directly manipulate AndroidManifest.xml via json override mechanism
Injects / Overrides values in AndroidManifest.xml file of generated android based project
IMPORTANT: always ensure that your object contains
tagandandroid:nameto target correct tag to merge into
Properties of the AndroidManifest_xml object:
tag (string, required)
package (string)
xmlns:android (string)
xmlns:tools (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
android:name (string)
android:theme (string)
android:value
android:required (boolean)
android:allowBackup (boolean)
android:largeHeap (boolean)
android:label (string)
android:icon (string)
android:roundIcon (string)
android:banner (string)
tools:replace (string)
android:supportsRtl (boolean)
tools:targetApi (number)
android:usesCleartextTraffic (boolean)
android:appComponentFactory (string)
android:screenOrientation (string)
android:noHistory (boolean)
android:launchMode (string)
android:exported (boolean)
android:configChanges (string)
android:windowSoftInputMode (string)
children (array)
strings_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the strings_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
styles_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the styles_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
colors_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the colors_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
MainApplication_kt (object)
Allows you to configure behaviour of MainActivity
Properties of the MainApplication_kt object:
imports (array)
The object is an array with all elements of the type string.
methods (array)
The object is an array with all elements of the type string.
createMethods (array)
The object is an array with all elements of the type string.
packages (array)
The object is an array with all elements of the type string.
packageParams (array)
The object is an array with all elements of the type string.
MainActivity_kt (object)
Properties of the MainActivity_kt object:
onCreate (string)
Overrides super.onCreate method handler of MainActivity.kt
Default: "super.onCreate(savedInstanceState)"
imports (array)
The object is an array with all elements of the type string.
methods (array)
The object is an array with all elements of the type string.
createMethods (array)
The object is an array with all elements of the type string.
resultMethods (array)
The object is an array with all elements of the type string.
SplashActivity_kt (object)
Properties of the SplashActivity_kt object:
settings_gradle (object)
Properties of the settings_gradle object:
include (array, required)
The object is an array with all elements of the type string.
project (array, required)
The object is an array with all elements of the type string.
gradle_wrapper_properties (object)
Properties of the gradle_wrapper_properties object:
proguard_rules_pro (object)
Properties of the proguard_rules_pro object:
androidwear (object)
Properties of the androidwear object:
buildSchemes (object)
Properties of the buildSchemes object:
includedPermissions (array)
Allows you to include specific permissions by their KEY defined in permissions object. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPermissions (array)
Allows you to exclude specific permissions by their KEY defined in permissions object. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
id (string)
Bundle ID of application. ie: com.example.myapp
idSuffix (string)
version (string)
Semver style version of your app
versionCode (string)
Manual verride of generated version code
versionFormat (string)
Allows you to fine-tune app version defined in package.json or renative.json. If you do not define versionFormat, no formatting will apply to version.
versionCodeFormat (string)
Allows you to fine-tune auto generated version codes. Version code is autogenerated from app version defined in package.json or renative.json.
versionCodeOffset (number)
title (string)
Title of your app will be used to create title of the binary. ie App title of installed app iOS/Android app or Tab title of the website
description (string)
General description of your app. This prop will be injected to actual projects where description field is applicable
author (string)
Author name
license (string)
Injects license information into app
includedFonts (array)
Array of fonts you want to include in specific app or scheme. Should use exact font file (without the extension) located in ./appConfigs/base/fonts or * to mark all
The object is an array with all elements of the type string.
backgroundColor (string)
Defines root view backgroundColor for all platforms in HEX format
Constraints:
- Regex pattern:
^#
splashScreen (boolean)
Enable or disable splash screen
fontSources (array)
Array of paths to location of external Fonts. you can use resolve function here example: {{resolvePackage(react-native-vector-icons)}}/Fonts
The object is an array with all elements of the type string.
assetSources (array)
Array of paths to alternative external assets. this will take priority over ./appConfigs/base/assets folder on your local project. You can use resolve function here example: {{resolvePackage(@flexn/template-starter)}}/appConfigs/base/assets
The object is an array with all elements of the type string.
includedPlugins (array)
Defines an array of all included plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: includedPlugins is evaluated before excludedPlugins. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPlugins (array)
Defines an array of all excluded plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: excludedPlugins is evaluated after includedPlugins. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
runtime
This object will be automatically injected into ./platfromAssets/renative.runtime.json making it possible to inject the values directly to JS source code
custom
Object used to extend your renative with custom props. This allows renative json schema to be validated
extendPlatform (string, enum)
This element must be one of the following enum values:
webiosandroidandroidtvfiretvtvosmacoslinuxwindowstizenweboschromecastkaioswebtvandroidweartizenwatchtizenmobilexbox
assetFolderPlatform (string)
Alternative platform assets. This is useful for example when you want to use same android assets in androidtv and want to avoid duplicating assets
engine (string)
ID of engine to be used for this platform. Note: engine must be registered in engines field
entryFile (string)
Alternative name of the entry file without .js extension
Default: "index"
bundleAssets (boolean)
If set to true compiled js bundle file will generated. this is needed if you want to make production like builds
enableSourceMaps (boolean)
If set to true dedicated source map file will be generated alongside of compiled js bundle
bundleIsDev (boolean)
If set to true debug build will be generated
getJsBundleFile (string)
enableAndroidX (boolean,string)
Enables new android X architecture
Default: true
enableJetifier (boolean,string)
Enables Jetifier
Default: true
signingConfig (string)
Equivalent to running ./gradlew/assembleDebug or ./gradlew/assembleRelease
Default: "Debug"
minSdkVersion (number)
Minimum Android SDK version device has to have in order for app to run
Default: 28
multipleAPKs (boolean)
If set to true, apk will be split into multiple ones for each architecture: "armeabi-v7a", "x86", "arm64-v8a", "x86_64"
aab (boolean)
If set to true, android project will generate app.aab instead of apk
extraGradleParams (string)
Allows passing extra params to gradle command
minifyEnabled (boolean)
Sets minifyEnabled buildType property in app/build.gradle
targetSdkVersion (number)
Allows you define custom targetSdkVersion equivalent to: targetSdkVersion = [VERSION] in build.gradle
compileSdkVersion (number)
Allows you define custom compileSdkVersion equivalent to: compileSdkVersion = [VERSION] in build.gradle
kotlinVersion (string)
Allows you define custom kotlin version
Default: "1.7.10"
ndkVersion (string)
Allows you define custom ndkVersion equivalent to: ndkVersion = [VERSION] in build.gradle
supportLibVersion (string)
Allows you define custom supportLibVersion equivalent to: supportLibVersion = [VERSION] in build.gradle
googleServicesVersion (string)
Allows you define custom googleServicesVersion equivalent to: googleServicesVersion = [VERSION] in build.gradle
gradleBuildToolsVersion (string)
Allows you define custom gradle build tools version equivalent to: classpath 'com.android.tools.build:gradle:[VERSION]'
gradleWrapperVersion (string)
Allows you define custom gradle wrapper version equivalent to: distributionUrl=https\://services.gradle.org/distributions/gradle-[VERSION]-all.zip
excludedFeatures (array)
Override features definitions in AndroidManifest.xml by exclusion
The object is an array with all elements of the type string.
includedFeatures (array)
Override features definitions in AndroidManifest.xml by inclusion
The object is an array with all elements of the type string.
buildToolsVersion (string)
Override android build tools version
Default: "34.0.0"
disableSigning (boolean)
storeFile (string)
Name of the store file in android project
keyAlias (string)
Key alias of the store file in android project
newArchEnabled (boolean)
Enables new arch for android. Default: false
flipperEnabled (boolean)
Enables flipper for ios. Default: true
reactNativeEngine (string, enum)
Allows you to define specific native render engine to be used
This element must be one of the following enum values:
jscv8-androidv8-android-nointlv8-android-jitv8-android-jit-nointlhermes
Default: "hermes"
templateAndroid (object)
Properties of the templateAndroid object:
gradle_properties (object)
Overrides values in gradle.properties file of generated android based project
build_gradle (object)
Overrides values in build.gradle file of generated android based project
Properties of the build_gradle object:
plugins (array)
The object is an array with all elements of the type string.
buildscript (object)
Properties of the buildscript object:
repositories (array, required)
The object is an array with all elements of the type string.
dependencies (array, required)
The object is an array with all elements of the type string.
ext (array, required)
The object is an array with all elements of the type string.
custom (array, required)
The object is an array with all elements of the type string.
injectAfterAll (array)
The object is an array with all elements of the type string.
app_build_gradle (object)
Overrides values in app/build.gradle file of generated android based project
Properties of the app_build_gradle object:
apply (array)
The object is an array with all elements of the type string.
defaultConfig (array)
The object is an array with all elements of the type string.
buildTypes (object)
Properties of the buildTypes object:
debug (array)
The object is an array with all elements of the type string.
release (array)
The object is an array with all elements of the type string.
afterEvaluate (array)
The object is an array with all elements of the type string.
implementations (array)
The object is an array with all elements of the type string.
implementation (string)
AndroidManifest_xml (object)
Allows you to directly manipulate AndroidManifest.xml via json override mechanism
Injects / Overrides values in AndroidManifest.xml file of generated android based project
IMPORTANT: always ensure that your object contains
tagandandroid:nameto target correct tag to merge into
Properties of the AndroidManifest_xml object:
tag (string, required)
package (string)
xmlns:android (string)
xmlns:tools (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
android:name (string)
android:theme (string)
android:value
android:required (boolean)
android:allowBackup (boolean)
android:largeHeap (boolean)
android:label (string)
android:icon (string)
android:roundIcon (string)
android:banner (string)
tools:replace (string)
android:supportsRtl (boolean)
tools:targetApi (number)
android:usesCleartextTraffic (boolean)
android:appComponentFactory (string)
android:screenOrientation (string)
android:noHistory (boolean)
android:launchMode (string)
android:exported (boolean)
android:configChanges (string)
android:windowSoftInputMode (string)
children (array)
strings_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the strings_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
styles_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the styles_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
colors_xml (object)
Allows you to directly manipulate res/values files via json override mechanism
Injects / Overrides values in res/values files of generated android based project
IMPORTANT: always ensure that your object contains
tagandnameto target correct tag to merge into
Properties of the colors_xml object:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
The object is an array with all elements of the type object.
The array object has the following properties:
tag (string, required)
name (string)
parent (string)
value (string)
children (array)
MainApplication_kt (object)
Allows you to configure behaviour of MainActivity
Properties of the MainApplication_kt object:
imports (array)
The object is an array with all elements of the type string.
methods (array)
The object is an array with all elements of the type string.
createMethods (array)
The object is an array with all elements of the type string.
packages (array)
The object is an array with all elements of the type string.
packageParams (array)
The object is an array with all elements of the type string.
MainActivity_kt (object)
Properties of the MainActivity_kt object:
onCreate (string)
Overrides super.onCreate method handler of MainActivity.kt
Default: "super.onCreate(savedInstanceState)"
imports (array)
The object is an array with all elements of the type string.
methods (array)
The object is an array with all elements of the type string.
createMethods (array)
The object is an array with all elements of the type string.
resultMethods (array)
The object is an array with all elements of the type string.
SplashActivity_kt (object)
Properties of the SplashActivity_kt object:
settings_gradle (object)
Properties of the settings_gradle object:
include (array, required)
The object is an array with all elements of the type string.
project (array, required)
The object is an array with all elements of the type string.
gradle_wrapper_properties (object)
Properties of the gradle_wrapper_properties object:
proguard_rules_pro (object)
Properties of the proguard_rules_pro object:
includedPermissions (array)
Allows you to include specific permissions by their KEY defined in permissions object. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPermissions (array)
Allows you to exclude specific permissions by their KEY defined in permissions object. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
id (string)
Bundle ID of application. ie: com.example.myapp
idSuffix (string)
version (string)
Semver style version of your app
versionCode (string)
Manual verride of generated version code
versionFormat (string)
Allows you to fine-tune app version defined in package.json or renative.json. If you do not define versionFormat, no formatting will apply to version.
versionCodeFormat (string)
Allows you to fine-tune auto generated version codes. Version code is autogenerated from app version defined in package.json or renative.json.
versionCodeOffset (number)
title (string)
Title of your app will be used to create title of the binary. ie App title of installed app iOS/Android app or Tab title of the website
description (string)
General description of your app. This prop will be injected to actual projects where description field is applicable
author (string)
Author name
license (string)
Injects license information into app
includedFonts (array)
Array of fonts you want to include in specific app or scheme. Should use exact font file (without the extension) located in ./appConfigs/base/fonts or * to mark all
The object is an array with all elements of the type string.
backgroundColor (string)
Defines root view backgroundColor for all platforms in HEX format
Constraints:
- Regex pattern:
^#
splashScreen (boolean)
Enable or disable splash screen
fontSources (array)
Array of paths to location of external Fonts. you can use resolve function here example: {{resolvePackage(react-native-vector-icons)}}/Fonts
The object is an array with all elements of the type string.
assetSources (array)
Array of paths to alternative external assets. this will take priority over ./appConfigs/base/assets folder on your local project. You can use resolve function here example: {{resolvePackage(@flexn/template-starter)}}/appConfigs/base/assets
The object is an array with all elements of the type string.
includedPlugins (array)
Defines an array of all included plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: includedPlugins is evaluated before excludedPlugins. Use: ['*'] to include all
The object is an array with all elements of the type string.
excludedPlugins (array)
Defines an array of all excluded plugins for specific config or buildScheme. only full keys as defined in plugin should be used.
NOTE: excludedPlugins is evaluated after includedPlugins. Use: ['*'] to exclude all
The object is an array with all elements of the type string.
runtime
This object will be automatically injected into ./platfromAssets/renative.runtime.json making it possible to inject the values directly to JS source code
custom
Object used to extend your renative with custom props. This allows renative json schema to be validated
extendPlatform (string, enum)
This element must be one of the following enum values:
webiosandroidandroidtvfiretvtvosmacoslinuxwindowstizenweboschromecastkaioswebtvandroidweartizenwatchtizenmobilexbox
assetFolderPlatform (string)
Alternative platform assets. This is useful for example when you want to use same android assets in androidtv and want to avoid duplicating assets