@maccesar/titools 2.0.7 → 2.2.0

package/skills/ti-guides/references/application-frameworks.md

@@ -2,7 +2,6 @@
 
 Framework options and architectural patterns for Titanium applications.
 
-## Table of Contents
 1. [Alloy Framework](#alloy-framework)
 2. [Classic Titanium](#classic-titanium)
 3. [Choosing a Framework](#choosing-a-framework)
@@ -12,7 +11,7 @@ Framework options and architectural patterns for Titanium applications.
 
 ## Alloy Framework
 
-**Alloy** is the official MVC framework for Titanium, developed by TiDev.
+**Alloy** is the official MVC framework for Titanium, originally developed by Appcelerator and now maintained by TiDev.
 
 ### What is Alloy?
 
@@ -79,6 +78,14 @@ $.index.open();
 - **Alloy Data:** See `alloy-data-mastery.md`
 - **Alloy Widgets:** See `alloy-widgets-and-themes.md`
 
+### Angular Integration
+
+Angular integration with Titanium SDK was under development but is no longer actively maintained.
+
+### React Community Framework
+
+A community-based React integration exists at https://github.com/nicolomonili/react-titanium (experimental).
+
 ### When to Use Alloy
 
 ✅ **Use Alloy for:**

package/skills/ti-guides/references/cli-reference.md

@@ -12,6 +12,15 @@ ti setup check
 
 Reports configured tools and potential issues.
 
+### Setup Wizard
+
+```bash
+ti setup
+ti setup <section>
+```
+
+Runs the interactive setup wizard. The `<section>` can be one of: **quick**, **check**, **user**, **app**, **network**, **cli**, **sdk**, **ios**, **android**, and **paths**.
+
 ### Get System Info
 
 ```bash
@@ -25,6 +34,24 @@ ti info -p android  # Android-specific info
 ti info -p ios      # iOS-specific info
 ```
 
+#### Info Options
+
+| Option | Description |
+| --- | --- |
+| `-o, --output <value>` | Output format: **report** or **json**. Defaults to **report**. |
+| `-t, --types <value>` | Comma-separated list of types: **all**, **os**, **nodejs**, **titanium**, **ios**, **jdk**, **haxm**, **android**. Defaults to **all**. |
+
+### Help
+
+Displays the help screen for the CLI or a specific command.
+
+```bash
+ti help
+ti help <command>
+ti --help
+ti <command> --help
+```
+
 ### Configure CLI
 
 ```bash
@@ -41,6 +68,14 @@ ti config -a paths.hooks "/path/to/hook"
 ti config -r android
 ```
 
+#### Config Options
+
+| Option | Description |
+| --- | --- |
+| `-a, --append` | Append a value to a key containing a list of values. |
+| `-r, --remove` | Remove the specified config key and all its descendants. |
+| `-o, --output <value>` | Output format: **report**, **json**, or **json-object**. Defaults to **report**. |
+
 **Alternative methods:**
 ```bash
 # Pass JSON string
@@ -73,12 +108,15 @@ ti create -t app --id <APP_ID> -n <APP_NAME> -p <PLATFORMS> -d <WORKSPACE> -u <U
 
 **Parameters:**
 - `--alloy`: Create an Alloy project (recommended for new projects)
-- `-t, --type`: Project type (`app`)
+- `-t, --type`: Project type: **app** (default), **applewatch**, **module** (or **timodule**)
 - `--id`: App ID (reverse domain notation)
 - `-n, --name`: App name
 - `-p, --platforms`: Comma-separated platforms (`android`, `ios`, `ipad`, `iphone`)
-- `-d, --dir`: Workspace directory
+- `-d, --workspace-dir`: Workspace directory
 - `-u, --url`: App URL
+- `-f, --force`: Force creation even if the path already exists
+- `--template`: Project template to use (name, directory, ZIP file, or remote ZIP URL)
+- `-s, --sdk`: Titanium SDK version to use
 
 > **Note:** Always use the `--alloy` flag when creating new projects. The Alloy framework provides MVC structure, data binding, and modern development patterns. Use Classic (`--classic` or omitting `--alloy`) only when maintaining legacy projects.
 
@@ -88,10 +126,54 @@ ti create -t app --id <APP_ID> -n <APP_NAME> -p <PLATFORMS> -d <WORKSPACE> -u <U
 ti build -p <PLATFORM> [OPTIONS]
 ```
 
+### Project Management
+
+```bash
+ti project [OPTIONS] [<key>] [<value>]
+```
+
+Gets and sets `tiapp.xml` settings. When called with a key, returns the value. When called with a key and value, sets the value in `tiapp.xml`.
+
+It also allows you to set the deployment-targets using a comma-separated list of platforms. If a specific platform is being enabled for the first time, it will also non-destructively copy that platform's default resources into your project's Resources folder.
+
+**Examples:**
+```bash
+# Get a tiapp.xml value
+ti project sdk-version
+
+# Set a tiapp.xml value
+ti project sdk-version 12.2.0.GA
+
+# Set deployment targets (must list all desired platforms)
+ti project deployment-targets iphone,ipad,android
+```
+
+**Tasks:**
+- `scan`: Scan directory for Titanium projects.
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `-o, --output <value>` | Output format: **report**, **json**, or **text**. Defaults to **report**. |
+| `--project-dir <directory>` | Directory containing the project. Defaults to current working directory. |
+
 ---
 
 ## Build Commands
 
+### Generic Build Options and Flags
+
+| Option | Description |
+| --- | --- |
+| `-b, --build-only` | Only perform the build; does not install or run the app. |
+| `-f, --force` | Force a clean rebuild. |
+| `--skip-js-minify` | Bypass JavaScript minification. Simulator builds are never minified. Only supported for Android and iOS. |
+| `--log-level <level>` | Minimum logging level: **trace**, **debug**, **info**, **warn**, **error**. |
+| `-p, --platforms <platform>` | Target build platform: **android** or **ios** (**iphone** and **ipad** are accepted as synonyms for **ios**). |
+| `-d, --project-dir <directory>` | Directory containing the project. Defaults to current working directory. |
+| `-s, --sdk <version>` | Titanium SDK version to build with. |
+
 ### Android Emulator
 
 ```bash
@@ -118,6 +200,23 @@ ti build -p android -T device -C deadbeef
 
 Omit `-C` if only one device connected.
 
+### Android Build Options
+
+| Option | Description |
+| --- | --- |
+| `-A, --android-sdk <path>` | Path to the Android SDK. |
+| `-C, --device-id <name>` | Name of the device or emulator. Use "all" with --target "device" to install on all connected devices. |
+| `-D, --deploy-type <type>` | Controls optimization, encryption, analytics: **development**, **test**, **production**. |
+| `-K, --keystore <path>` | Location of the keystore file. |
+| `--key-password <keypass>` | Password of the keystore private key. Defaults to --store-password value. |
+| `--liveview` | Start a LiveView session for live UI previews. |
+| `-L, --alias <alias>` | Alias for the keystore. |
+| `--no-launch` | Disable launching the app after installing. |
+| `-O, --output-dir <dir>` | Output directory (used when target is **dist-playstore**). |
+| `-P, --store-password <password>` | Password for the keystore. |
+| `--sigalg <algorithm>` | Digital signature algorithm: **MD5withRSA**, **SHA1withRSA**, **SHA256withRSA**. |
+| `-T, --target <value>` | Target: **emulator**, **device**, or **dist-playstore**. |
+
 ### iOS Simulator
 
 ```bash
@@ -142,6 +241,29 @@ ti build -p ios -T device -C itunes -V "Loretta Martin (GE7BAC5)" -P "11111111-2
 
 Omit `-V` and `-P` to be prompted.
 
+### iOS Build Options
+
+| Option | Description |
+| --- | --- |
+| `-C, --device-id <name>` | Name of the device or simulator. Use "all" with --target "device" to install on all connected devices. |
+| `-D, --deploy-type <type>` | Controls optimization, encryption, analytics: **development**, **test**, **production**. |
+| `-F, --device-family <value>` | Device family: **iphone**, **ipad**, or **universal** (default). |
+| `--force-copy` | Force files to be copied instead of symlinked (simulator builds only). |
+| `-I, --ios-version <value>` | iOS SDK version to build for. Default: latest installed. |
+| `-K, --keychain <value>` | Path to distribution keychain (for device/dist targets). |
+| `--launch-bundle-id <id>` | After installing in simulator, launch a different app (useful for test runners). |
+| `--launch-watch-app` | Launch both the watch app and main app (simulator only). |
+| `--launch-watch-app-only` | Launch only the watch app (simulator only). |
+| `-O, --output-dir <dir>` | Output directory (used when target is **dist-adhoc**). |
+| `-P, --pp-uuid <uuid>` | Provisioning profile UUID (for device/dist targets). |
+| `-R, --distribution-name <name>` | iOS Distribution Certificate (for dist targets). |
+| `--sim-focus` | Focus the iOS Simulator after launching (default: true). Use --no-sim-focus to disable. |
+| `-T, --target <value>` | Target: **simulator**, **device**, **dist-appstore**, or **dist-adhoc**. |
+| `-V, --developer-name <name>` | iOS Developer Certificate (required for device target). |
+| `-W, --watch-device-id <udid>` | Watch simulator UDID (simulator only). |
+| `--watch-app-name <name>` | Name of the watch app to launch (simulator only). |
+| `-Y, --sim-type <type>` | iOS Simulator type: **iphone** or **ipad** (simulator only). |
+
 ### Clean Build
 
 ```bash
@@ -154,6 +276,15 @@ ti clean          # All platforms
 ti clean -p ios   # iOS only
 ```
 
+#### Clean Options
+
+| Option | Description |
+| --- | --- |
+| `-p, --platforms <platform>` | A single platform to clean: **android** or **ios**. |
+| `-d, --project-dir <directory>` | Directory containing the project. Defaults to current working directory. |
+| `-s, --sdk <version>` | Titanium SDK version. |
+| `--log-level <level>` | Minimum logging level: **trace**, **debug**, **info**, **warn**, **error**. |
+
 ### Module Management
 
 ```bash
@@ -162,15 +293,62 @@ ti module [TASK] [OPTIONS]
 
 **Tasks:**
 - `create`: Create a new Titanium module.
+- `list`: List installed Titanium modules.
 
-### Project Management
+#### Module Create
 
 ```bash
-ti project [TASK] [OPTIONS]
+ti create -t module --id <MODULE_ID> -n <MODULE_NAME> -p <PLATFORMS> -d <WORKSPACE>
 ```
 
-**Tasks:**
-- `scan`: Scan directory for Titanium projects.
+**Parameters:**
+- `-t, --type`: Set to **module** (or **timodule**)
+- `--id`: Module ID (reverse domain notation)
+- `-n, --name`: Module name
+- `-p, --platforms`: Target platforms
+- `-d, --workspace-dir`: Workspace directory
+- `-f, --force`: Force creation even if path already exists
+- `--template`: Module template to use
+
+#### Module List
+
+Prints a list of installed modules.
+
+```bash
+ti module
+ti module list
+ti module list --project-dir /path/to/project
+```
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `-o, --output <value>` | Output format: **report**, **json**, or **grid**. Defaults to **report**. |
+| `--project-dir <value>` | Directory of the project to analyze. Defaults to current working directory. |
+
+### Plugin Management
+
+```bash
+ti plugin [TASK] [OPTIONS]
+```
+
+#### Plugin List
+
+Prints a list of installed plugins.
+
+```bash
+ti plugin
+ti plugin list
+ti plugin list --project-dir /path/to/project
+```
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `-o, --output <value>` | Output format: **report**, **json**, or **grid**. Defaults to **report**. |
+| `--project-dir <value>` | Directory of the project to analyze. Defaults to current working directory. |
 
 ---
 
@@ -226,13 +404,71 @@ Installs package to Xcode Organizer.
 ti sdk list
 ```
 
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `-b, --branches` | Retrieve and print all branches. |
+| `-r, --releases` | Retrieve and print all releases. |
+| `-o, --output <value>` | Output format: **report** or **json**. Defaults to **report**. |
+
 ### Select SDK
 
 ```bash
-ti sdk select
+ti sdk select [<version>]
+```
+
+Interactive selection of default SDK. This sets the SDK used to run CLI commands. If the `tiapp.xml` file does not contain an SDK version and the `app.sdk` setting is not set, the application will be built with this SDK.
+
+### Install SDK
+
+Downloads the latest Titanium SDK or a specific version.
+
+```bash
+ti sdk install [<version>] [--default] [--force] [--branch <branch_name>]
 ```
 
-Interactive selection of default SDK.
+`<version>` may be a specific version number (e.g. `12.2.0.GA`), a URL to a ZIP file, or a local ZIP file path.
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `-d, --default` | Set as the default SDK. |
+| `-f, --force` | Force reinstallation. |
+| `-k, --keep-files` | Keep downloaded files after install. |
+| `-b, --branch <branch_name>` | Branch to install from, or "latest". |
+
+### Uninstall SDK
+
+Uninstalls a specific Titanium SDK version.
+
+```bash
+ti sdk uninstall [<version>] [--force]
+```
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `-f, --force` | Force uninstallation without confirmation. |
+
+### Update SDK
+
+Finds the latest version of the Titanium SDK and optionally installs it.
+
+```bash
+ti sdk update [--default] [--force] [--install] [--branch <branch_name>]
+```
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `-d, --default` | Set as the default SDK. |
+| `-f, --force` | Force reinstallation. |
+| `-i, --install` | Install the latest version. |
+| `-b, --branch <branch_name>` | Branch to update from. |
 
 ---
 
@@ -240,93 +476,96 @@ Interactive selection of default SDK.
 
 ### Android Options
 
-| Option                               | Default     | Description                      |
-| ------------------------------------ | ----------- | -------------------------------- |
-| `android.sdkPath`                    | auto        | Android SDK path                 |
-| `android.ndkPath`                    | auto        | Android NDK path                 |
-| `android.adb.port`                   | 5037        | ADB port number                  |
-| `android.autoSelectDevice`           | true        | Auto-select device/emulator      |
-| `android.symlinkResources`           | true (OS X) | Symlink vs copy resources        |
-| `android.buildTools.selectedVersion` | max         | Build tools version              |
-| `android.javac.maxmemory`            | "1024M"     | JVM heap size                    |
-| `android.javac.source`               | "1.6"       | Java source version              |
-| `android.javac.target`               | "1.6"       | Java target version              |
-| `android.mergeCustomAndroidManifest` | false       | Merge custom AndroidManifest.xml |
+| Option | Default | Description |
+| --- | --- | --- |
+| `android.sdkPath` | auto | Android SDK path |
+| `android.ndkPath` | auto | Android NDK path |
+| `android.adb.port` | 5037 | ADB port number |
+| `android.autoSelectDevice` | true | Auto-select device/emulator |
+| `android.symlinkResources` | true (OS X) | Symlink vs copy resources |
+| `android.buildTools.selectedVersion` | max | Build tools version |
+| `android.javac.maxmemory` | "3072M" | JVM heap size |
+| `android.javac.source` | "1.8" | Java source version |
+| `android.javac.target` | "1.8" | Java target version |
+| `android.mergeCustomAndroidManifest` | false | Merge custom AndroidManifest.xml |
+
+> **Note:** The `android.javac.source` and `android.javac.target` defaults were originally "1.6" in earlier SDK versions. Modern Titanium SDK requires Java 1.8 or higher. These can be overridden per-project in `tiapp.xml` using `<property name="android.javac.source" type="string">1.8</property>`.
 
 ### iOS Options
 
-| Option                 | Default     | Description                           |
-| ---------------------- | ----------- | ------------------------------------- |
-| `ios.developerName`    | -           | Developer certificate name            |
-| `ios.distributionName` | -           | Distribution certificate name         |
-| `ios.autoSelectDevice` | true        | Auto-select device/simulator          |
-| `ios.symlinkResources` | true (OS X) | Symlink vs copy resources             |
-| `ios.keychain`         | -           | Specific keychain to search for certs |
-| `ios.xcodePath`        | auto        | Path to Xcode installation            |
+| Option | Default | Description |
+| --- | --- | --- |
+| `ios.developerName` | - | Developer certificate name |
+| `ios.distributionName` | - | Distribution certificate name |
+| `ios.autoSelectDevice` | true | Auto-select device/simulator |
+| `ios.symlinkResources` | true (OS X) | Symlink vs copy resources |
+| `ios.keychain` | - | Specific keychain to search for certs |
+| `ios.xcodePath` | auto | Path to Xcode installation |
 
 ### CLI Options
 
-| Option                   | Default | Description                                   |
-| ------------------------ | ------- | --------------------------------------------- |
-| `cli.logLevel`           | trace   | Log level: error, warning, info, debug, trace |
-| `cli.colors`             | true    | Color output                                  |
-| `cli.progressBars`       | true    | Show progress bars                            |
-| `cli.prompt`             | true    | Prompt for missing info                       |
-| `cli.quiet`              | false   | Suppress all output                           |
-| `cli.rejectUnauthorized` | true    | Reject bad SSL certs                          |
-| `cli.width`              | 100     | Text wrap width                               |
-| `cli.failOnWrongSDK`     | false   | Fail on SDK mismatch                          |
-| `cli.hideCharEncWarning` | false   | Hide encoding warnings                        |
-| `cli.httpProxyServer`    | -       | Proxy server URL                              |
+| Option | Default | Description |
+| --- | --- | --- |
+| `cli.logLevel` | trace | Log level: error, warning, info, debug, trace |
+| `cli.colors` | true | Color output |
+| `cli.progressBars` | true | Show progress bars |
+| `cli.prompt` | true | Prompt for missing info |
+| `cli.quiet` | false | Suppress all output |
+| `cli.rejectUnauthorized` | true | Reject bad SSL certs |
+| `cli.width` | 100 | Text wrap width |
+| `cli.failOnWrongSDK` | false | Fail on SDK mismatch |
+| `cli.hideCharEncWarning` | false | Hide encoding warnings |
+| `cli.httpProxyServer` | - | Proxy server URL |
 
 ### SDK Options
 
-| Option                       | Description                        |
-| ---------------------------- | ---------------------------------- |
+| Option | Description |
+| --- | --- |
 | `sdk.defaultInstallLocation` | SDK install location (OS-specific) |
-| `sdk.selected`               | Selected SDK version (REQUIRED)    |
+| `sdk.selected` | Selected SDK version (REQUIRED) |
 
 ### Paths
 
-| Option           | Description                    |
-| ---------------- | ------------------------------ |
+| Option | Description |
+| --- | --- |
 | `paths.commands` | Additional CLI command scripts |
-| `paths.hooks`    | CLI hook scripts               |
-| `paths.modules`  | Module search paths            |
-| `paths.plugins`  | Plugin search paths            |
-| `paths.sdks`     | SDK search paths               |
-| `paths.xcode`    | Xcode installation paths       |
+| `paths.hooks` | CLI hook scripts |
+| `paths.modules` | Module search paths |
+| `paths.plugins` | Plugin search paths |
+| `paths.sdks` | SDK search paths |
+| `paths.xcode` | Xcode installation paths |
 
 ### Java Options
 
-| Option                       | Description               |
-| ---------------------------- | ------------------------- |
-| `java.home`                  | JDK directory             |
-| `java.executables.java`      | java executable path      |
-| `java.executables.javac`     | javac executable path     |
+| Option | Description |
+| --- | --- |
+| `java.home` | JDK directory |
+| `java.executables.java` | java executable path |
+| `java.executables.javac` | javac executable path |
 | `java.executables.jarsigner` | jarsigner executable path |
-| `java.executables.keytool`   | keytool executable path   |
+| `java.executables.keytool` | keytool executable path |
 
 ### Genymotion Options
 
-| Option                              | Description               |
-| ----------------------------------- | ------------------------- |
-| `genymotion.enabled`                | Enable Genymotion support |
-| `genymotion.path`                   | Genymotion app directory  |
-| `genymotion.executables.genymotion` | genymotion executable     |
-| `genymotion.executables.player`     | player executable         |
-| `genymotion.executables.vboxmanage` | vboxmanage executable     |
+| Option | Description |
+| --- | --- |
+| `genymotion.enabled` | Enable Genymotion support |
+| `genymotion.home` | Genymotion virtual machine data directory |
+| `genymotion.path` | Genymotion app directory |
+| `genymotion.executables.genymotion` | genymotion executable |
+| `genymotion.executables.player` | player executable |
+| `genymotion.executables.vboxmanage` | vboxmanage executable |
 
 ### Application Options
 
-| Option                      | Description                 |
-| --------------------------- | --------------------------- |
-| `app.idprefix`              | Prefix for new app IDs      |
-| `app.publisher`             | Default publisher           |
-| `app.url`                   | Default company URL         |
-| `app.workspace`             | Default workspace directory |
-| `app.skipAppIdValidation`   | Skip app ID validation      |
-| `app.skipVersionValidation` | Skip version validation     |
+| Option | Description |
+| --- | --- |
+| `app.idprefix` | Prefix for new app IDs |
+| `app.publisher` | Default publisher |
+| `app.url` | Default company URL |
+| `app.workspace` | Default workspace directory |
+| `app.skipAppIdValidation` | Skip app ID validation |
+| `app.skipVersionValidation` | Skip version validation |
 
 ---
 
@@ -372,17 +611,34 @@ adb devices
 
 ## Command Quick Reference
 
-| Command                 | Description             |
-| ----------------------- | ----------------------- |
-| `ti setup check`        | Check environment setup |
-| `ti info`               | Display system info     |
-| `ti info -p <PLATFORM>` | Platform-specific info  |
-| `ti config`             | Display/set config      |
-| `ti create`             | Create new project      |
-| `ti build`              | Build project           |
-| `ti clean`              | Clean build folder      |
-| `ti sdk list`           | List installed SDKs     |
-| `ti sdk select`         | Select default SDK      |
+| Command | Description |
+| --- | --- |
+| `ti help` | Display help screen |
+| `ti help <command>` | Display help for a specific command |
+| `ti setup` | Run setup wizard |
+| `ti setup check` | Check environment setup |
+| `ti setup <section>` | Run specific setup section (quick, check, user, app, network, cli, sdk, ios, android, paths) |
+| `ti info` | Display system info |
+| `ti info -p <PLATFORM>` | Platform-specific info |
+| `ti info -o json` | Output system info as JSON |
+| `ti config` | Display/set config |
+| `ti config -o json` | Output config as JSON |
+| `ti create` | Create new project |
+| `ti create -t module` | Create new module |
+| `ti build` | Build project |
+| `ti build -b` | Build only (no install/launch) |
+| `ti build -f` | Force clean rebuild |
+| `ti clean` | Clean build folder |
+| `ti clean -p <PLATFORM>` | Clean specific platform |
+| `ti project` | Get/set tiapp.xml settings |
+| `ti module list` | List installed modules |
+| `ti plugin list` | List installed plugins |
+| `ti sdk list` | List installed SDKs |
+| `ti sdk select` | Select default SDK |
+| `ti sdk install` | Install latest SDK |
+| `ti sdk install <version>` | Install specific SDK |
+| `ti sdk uninstall <version>` | Uninstall specific SDK |
+| `ti sdk update` | Check for SDK updates |
 
 ---
 

package/skills/ti-guides/references/coding-best-practices.md

@@ -1,5 +1,7 @@
 # Coding Best Practices
 
+The recommended standard for Titanium apps is a single-context, modular pattern with well-structured code and well-organized resources.
+
 ## 1. Scope Management
 - **Avoid Global Scope**: Global variables are not automatically garbage collected and can cause naming conflicts.
 - **Always use `let` or `const`**: (Original guide says `var`, but modernization rules apply). Omitting declarations places variables in the global scope.
@@ -40,16 +42,23 @@ win1.addEventListener('click', () => {
   const WindowTwo = require('ui/WindowTwo').WindowTwo;
   const win2 = new WindowTwo();
   win2.open();
+
+  win2.addEventListener('click', () => {
+    // load window three JavaScript only when needed
+    const WindowThree = require('ui/WindowThree').WindowThree;
+    const win3 = new WindowThree();
+    win3.open();
+  });
 });
 ```
 
 - **Bridge Efficiency**: Minimize requests for device properties like `Ti.Platform.osname`. Store them in a local variable once.
-- **Avoid Extending Ti Namespace**: Never add properties to `Ti.*` as it's a proxy system and leads to instability.
+- **Avoid Extending Ti Namespace**: Ti namespace objects are proxy representations of native OS components. Properties set on them may be stored on the proxy but won't be passed to the native object. Arrays stored on proxies return copies, not live references. There is no guarantee properties will persist across SDK versions. Use native modules instead to extend core functionality.
 
 ## 5. App Architecture Recommendations
 
 ### Modular Components with CommonJS (Recommended)
-Titanium's primary recommended architecture. Discrete and independent building blocks that eliminate global variables.
+Titanium's primary recommended architecture. Discrete and independent building blocks that eliminate global variables. See `commonjs-advanced.md` for detailed module patterns and path resolution.
 
 **MyModule.js**
 ```javascript
@@ -72,11 +81,12 @@ myModule.sayHello('User');
 ```
 
 ### Custom Objects as Components
-Popular for rapid deployment. Uses a namespace hierarchy.
+Popular for rapid deployment. Uses a namespace hierarchy. However, this pattern is less performant than CommonJS modules. Memory management can be difficult as object references may persist after they're no longer needed.
+
 ```javascript
 const myapp = {};
 (() => {
-  myapp.ui = {}; 
+  myapp.ui = {};
   myapp.ui.createApplicationWindow = () => {
     const win = Ti.UI.createWindow({ backgroundColor:'white' });
     return win;