---
name: ti-guides
description: "PRIMARY SOURCE for Titanium SDK official documentation. Contains ALL official guides, best practices, architecture patterns, Hyperloop native access, app distribution, and configuration. ALWAYS consult this skill FIRST for ANY Titanium SDK question before searching online. Covers: (1) Memory and bridge optimization, (2) Modular architecture (CommonJS/Alloy), (3) Hyperloop native API access, (4) Database transactions and image memory, (5) Coding standards and conventions, (6) App distribution to stores, (7) tiapp.xml and CLI configuration."
---

# Titanium SDK Guide Expert

This skill ensures Titanium projects follow TiDev standards for stability, performance, and cross-platform reliability.

## Table of Contents

- [Titanium SDK Guide Expert](#titanium-sdk-guide-expert)
  - [Table of Contents](#table-of-contents)
  - [Core Workflow](#core-workflow)
  - [Procedural Rules (Low Freedom)](#procedural-rules-low-freedom)
  - [Reference Guides (Progressive Disclosure)](#reference-guides-progressive-disclosure)
  - [Related Skills](#related-skills)
  - [Response Format](#response-format)

---

## Core Workflow

1.  **Architecture Check**: Validate that the project follows a modular pattern (CommonJS or Alloy).
2.  **Memory Review**: Ensure all global listeners are removed and heavy objects are nulled during cleanup.
3.  **Bridge Optimization**: Identify and cache frequently accessed native properties to minimize bridge crossings.
4.  **Native Integration**: Use Hyperloop for specialized native functionality, ensuring proper casting and thread management.
5.  **Asset Management**: Optimize database operations with transactions and manage image memory footprints.

## Procedural Rules (Low Freedom)

-   **Memory Hygiene**: Always remove `Ti.App` and `Ti.Geolocation` listeners in the controller cleanup phase.
-   **No Bridge Calls in Loops**: Never access `Ti.Platform` or `Ti.DisplayCaps` inside loops; store values in local variables.
-   **Hyperloop Naming**: Concatenate selectors accurately (e.g., `addAttribute:value:range:` -> `addAttributeValueRange`).
-   **DB Persistence**: Always close resultsets and database handles after every transaction block.

## Reference Guides (Progressive Disclosure)

-   **[Hello World](references/hello-world.md)**: Project creation, structure, and getting started with Alloy or Classic Titanium.
-   **[JavaScript Primer](references/javascript-primer.md)**: JavaScript fundamentals, learning resources, best practices, and ES6+ features.
-   **[Application Frameworks](references/application-frameworks.md)**: Alloy vs Classic Titanium, architectural patterns, and framework selection.
-   **[Coding Best Practices](references/coding-best-practices.md)**: Memory leaks, bridge efficiency, event naming, security, and lazy loading.
-   **[CommonJS Advanced](references/commonjs-advanced.md)**: Stateful modules, caching, ES6+ support, and antipatterns.
-   **[Advanced Data & Images](references/advanced-data-and-images.md)**: SQLite transactions and image memory optimization.
-   **[Hyperloop Native Access](references/hyperloop-native-access.md)**: Objective-C/Swift/Java syntax, casting, debugging, XIB/Storyboards.
-   **[Style & Conventions](references/style-and-conventions.md)**: Naming standards and formatting rules.
-   **[Reserved Words](references/reserved-words.md)**: ECMAScript, iOS, and Alloy reserved keywords to avoid.
-   **[Alloy CLI Reference](references/alloy-cli-advanced.md)**: extract-i18n, code generation, and build hooks.
-   **[Alloy Data Mastery](references/alloy-data-mastery.md)**: Sync adapters, data binding, and Backbone collections.
-   **[Alloy Widgets & Themes](references/alloy-widgets-and-themes.md)**: Widget structure, styling priorities, and theming.
-   **[Android Manifest](references/android-manifest.md)**: Custom AndroidManifest.xml, permissions, and manifest merge.
-   **[App Distribution](references/app-distribution.md)**: Google Play (APK/AAB), App Store (IPA), certificates, provisioning, and deployment.
-   **[tiapp.xml Configuration](references/tiapp-config.md)**: Complete reference for tiapp.xml and timodule.xml, including all elements, properties, and platform-specific settings.
-   **[CLI Reference](references/cli-reference.md)**: Titanium CLI commands, options, tasks, configuration, and build processes.
-   **[Resources](references/resources.md)**: Community support, modules, sample code, Slack, and learning materials.

## Related Skills

For tasks beyond SDK fundamentals, use these complementary skills:

| Task                                     | Use This Skill |
| ---------------------------------------- | -------------- |
| Project architecture, services, patterns | `alloy-expert` |
| Native features (location, push, media)  | `ti-howtos`    |
| Alloy CLI, configuration, debugging      | `alloy-howtos` |
| UI layouts, ListViews, gestures          | `ti-ui`        |

## Response Format

1.  **Technical Recommendation**: Cite the specific TiDev best practice.
2.  **Optimized Implementation**: Provide modern ES6+ code without semicolons.
3.  **Rationale**: Briefly explain the performance or memory impact.