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:
web
ios
android
androidtv
firetv
tvos
macos
linux
windows
tizen
webos
chromecast
kaios
webtv
androidwear
tizenwatch
tizenmobile
xbox
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:
web
ios
android
androidtv
firetv
tvos
macos
linux
windows
tizen
webos
chromecast
kaios
webtv
androidwear
tizenwatch
tizenmobile
xbox
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:
jsc
v8-android
v8-android-nointl
v8-android-jit
v8-android-jit-nointl
hermes
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
tag
andandroid:name
to 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
tag
andname
to 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
tag
andname
to 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
tag
andname
to 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:
web
ios
android
androidtv
firetv
tvos
macos
linux
windows
tizen
webos
chromecast
kaios
webtv
androidwear
tizenwatch
tizenmobile
xbox
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:
jsc
v8-android
v8-android-nointl
v8-android-jit
v8-android-jit-nointl
hermes
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
tag
andandroid:name
to 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
tag
andname
to 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
tag
andname
to 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
tag
andname
to 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:
web
ios
android
androidtv
firetv
tvos
macos
linux
windows
tizen
webos
chromecast
kaios
webtv
androidwear
tizenwatch
tizenmobile
xbox
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:
jsc
v8-android
v8-android-nointl
v8-android-jit
v8-android-jit-nointl
hermes
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
tag
andandroid:name
to 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
tag
andname
to 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
tag
andname
to 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
tag
andname
to 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:
web
ios
android
androidtv
firetv
tvos
macos
linux
windows
tizen
webos
chromecast
kaios
webtv
androidwear
tizenwatch
tizenmobile
xbox
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:
jsc
v8-android
v8-android-nointl
v8-android-jit
v8-android-jit-nointl
hermes
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
tag
andandroid:name
to 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
tag
andname
to 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
tag
andname
to 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
tag
andname
to 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:
web
ios
android
androidtv
firetv
tvos
macos
linux
windows
tizen
webos
chromecast
kaios
webtv
androidwear
tizenwatch
tizenmobile
xbox
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:
jsc
v8-android
v8-android-nointl
v8-android-jit
v8-android-jit-nointl
hermes
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
tag
andandroid:name
to 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
tag
andname
to 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
tag
andname
to 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
tag
andname
to 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:
web
ios
android
androidtv
firetv
tvos
macos
linux
windows
tizen
webos
chromecast
kaios
webtv
androidwear
tizenwatch
tizenmobile
xbox
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