B Properties in the oraclejetconfig.json File
oraclejetconfig.json
file supports a range of
properties that you can configure to determine the behavior of your Oracle JET
project.Note:
WhereProperty
is <prop>.<subprop>
it
indicates that <subprop>
is a subproperty of
<prop>
. For example, paths.components
means
"paths": { "components": "value" }
.
Table B-1 Properties in the oraclejetconfig.json File
Property | Value Type | Valid Values | Default | Notes |
---|---|---|---|---|
architecture | String | mvvm or vdom |
mvvm | Type of app architecture. |
components | Object | component name/version value pairs | ![]() |
Component name/version value pairs for components to be restored from
the component exchange upon
|
bundleName | String | simple file name with a .JS extension | bundle.js | Allows an override of the default name used for an optimized app. |
bundler | String | webpack | <any> |
![]() |
In release 11.0.0, JET introduced bundler-only support
for Webpack. If In release 12.0.0, JET introduced end-to-end Webpack
support. With the |
defaultBrowser | String | browser name | chrome | Sent to Apache Cordova when serving hybrid mobile apps
as --target when the destination is
browser .
|
defaultTheme | String | redwood, redwood-notag, stable | redwood |
Name of theme to use as the default in the app. |
dependencies | Object | component name/object or version number pairs | ![]() |
Names of potential component or pack dependencies used
to check whether certain pre-minified components should be excluded
from the
Or
|
enableDocGen | Boolean | true/false | ![]() |
When When |
enableLegacyPeerDeps | Boolean | True/False | False |
When |
exchange-url | String | URL | ![]() |
Component exchange instance for publishing components. For example: https://exchange.url.com/api/0.2.0 Note: This setting can also be inherited (if not present) from a global value defined throughojet configure
--exchange-url=<addr> --global which will be
stored centrally (for example,
.ojet/exchange-url.json )
|
fontUrl | String | URL | ![]() |
Link so that an Oracle JET CLI build
command can insert icon fonts into Oracle JET templates. This property
is associated with the injector:font token in the
appRootDir/src/index.html file of your app.
|
generateSourceMaps | Boolean | true/false | False | When true , the Oracle JET CLI configures Terser and RequireJS packages to generate source map files when you build the Oracle JET app using the ojet build or ojet serve commands.
|
generatorVersion | String | Oracle JET CLI version | ![]() |
Deprecated. Historical information about the version of JET that was first used to create the project. Not used by the CLI. |
installer | String | yarn or npm |
npm | If specified, an alternate installer to run instead of
the default npm for npm install type commands.
|
localComponentsSupport | Boolean | true/false | ![]() |
Indicates whether the component exchange backend
supports the local components extension. The value will
be recorded by the CLI in oraclejetconfig.json . If a
user wants to opt out of the local components support, they can set this
value to false deliberately.
|
paths.components | String | path | jet-composites |
Path where locally-created components are stored relative to a root that is dependent on the scaffolded project type:
Note: In a a project created with the vdombasic template or
--vdom option, this value will be pre-set to
just components rather than the default
jet-composites .
|
paths.exchangeComponents | String | path | exchange_components | Folder where components added from the exchange are
stored for new virtual DOM apps. Non-virtual DOM apps (MVVM) use the
older jet_components when this is not set. This path
must be a simple folder name which will be created in the root of the
project as a peer of the src/ folder.
|
paths.source.common | String | path | src | Simple folder name relative to the project root. A
folder hierarchy cannot be used here. Other settings such as
paths.components will be relative to this
location.
|
paths.source.hybrid | String | path | src-hybrid | Simple folder name relative to the project root. A folder hierarchy cannot be used here. |
paths.source.javascript | String | path | js | Simple folder name relative to the defined
src folder. A folder hierarchy cannot be used here.
Other settings such as paths.components may be relative
to this location in the relevant project type.
|
paths.source.styles | String | path | css | Simple folder name relative to the defined
src folder. A folder hierarchy cannot be used
here.
|
paths.source.themes | String | path | themes | Simple folder name relative to the defined
src folder. A folder hierarchy cannot be used
here.
|
paths.source.tsconfig | String | path | If specified, this subproperty enables the relocation of the tsconfig.json file from its default location at the app root. Simple folder name relative to the defined src folder. A folder hierarchy cannot be used here.
|
|
paths.source.typescript | String | path | ts | Simple folder name relative to the defined
src folder. A folder hierarchy cannot be used here.
Other settings such as paths.components may be relative
to this location in the relevant project type.
|
paths.source.web | String | path | src-web | Simple folder name relative to the defined
src folder. A folder hierarchy cannot be used
here.
|
paths.staging.hybrid | String | path | hybrid | Path where the hybrid build products are generated. |
paths.staging.themes | String | path | staged-themes | Path where themes are staged. |
paths.staging.web | String | path | web | Path where the web build products are generated. |
sassVer | String | semver-style version number | 1.80.5 | Dart Sass (sass ) NPM package version
that will be installed if sass is added
|
stripList | Array of strings | path strings | ![]() |
List of .gitignore -style paths to strip
when ojet strip is executed. This bypasses the list in
the .gitignore file.
|
unversioned | Boolean | true/false | false |
When
Without the
The
|
watchInterval | String | Number of milliseconds | 1000 | Configure the interval at which the live reload feature polls the
Oracle JET project for updates by configuring a value for this property.
The default value is 1000 milliseconds.
|
The remaining entries in this table describe the properties that you use to manage ICU translation bundles, as described in Work with ICU Translation Bundles in an Oracle JET Virtual DOM App. |
![]() |
![]() |
![]() |
![]() |
translationIcuLibraries | String | @oracle/oraclejet-icu-l10n | @oracle/oraclejet-icu-l10n |
The NPM package that the Oracle JET CLI's add translation command installs. You need this NPM package to generate ICU translation bundles. |
buildICUTranslationsBundle | Boolean | true/false | false |
When |
translation.type | String | icu | icu |
The only supported value at present for this property is |
translation.options.rootDir | String | Root directory for the runtime ICU translation bundles. | ./src/resources/nls |
The root directory for ICU translation bundles. The value that the |
translation.options.bundleName | String | Name of the ICU translation bundle | translationBundle.json |
The bundle name from which to generate runtime ICU translation bundles when you run the |
translation.options.locale | String | Language tag (For example, "en-US") | en-US |
The locale of the ICU translation bundle in the root directory. The value that the |
translation.options.outDir | String | Path to output directory | ./src/resources/nls |
The output directory for runtime ICU translation bundles. The value that the |
translation.options.supportedLocales | String | Array of supported locales | ![]() |
A comma-separated list of additional locales to build. If you specify a locale that does not have a corresponding entry in the |
translation.options.componentBundleName | String | Name of component-specific ICU translation bundle | ${componentName}-strings.json |
Specifies the naming pattern for the ICU translation bundle associated with a component. The If you create a component named |