foundation-platform-export-compatibility

name	foundation-platform-export-compatibility
description	Foundational skill for multi-platform Godot delivery. Aligns feature tags, platform constraints, export presets, and runtime fallbacks across desktop, mobile, web, and XR.
tier	core
godot_version	4.6+
doc_anchors	["godot-docs/tutorials/export/exporting_projects.rst","godot-docs/tutorials/export/feature_tags.rst","godot-docs/tutorials/platform/index.rst","godot-docs/tutorials/export/exporting_for_dedicated_servers.rst"]
tags	["platform","export","compatibility"]
depends_on	[]

Foundation Platform and Export Compatibility

Use When

• Features must run across multiple targets.
• You are adding platform APIs, XR, mobile, web, or dedicated-server behavior.
• You are preparing export/release workflows.

Outcomes

• Platform support matrix is explicit and testable.
• Feature-tag and capability gating rules are consistent.
• Export presets and runtime fallbacks are validated per target.

Required Rules

• Define supported platform matrix up front.
• Gate platform-specific behavior behind explicit feature tags/capability checks.
• Keep platform conditionals localized and documented.
• Validate export presets for each target.
• Provide fallback behavior for unsupported capabilities.

Workflow

1. Define supported target matrix and explicit non-targets.
2. Map feature tags/capability checks to affected systems.
3. Configure and review export presets for each target.
4. Implement fallback behaviors where capabilities are unavailable.
5. Run target-specific smoke tests and record results.

Validation

• Export presets build successfully for all supported targets.
• Capability-gated features disable cleanly on unsupported targets.
• Target smoke tests confirm startup, input, and core scene flow.

Failure Modes

• Platform checks are scattered, causing inconsistent behavior.
• Export presets drift from documented target matrix.
• Unsupported features fail hard instead of falling back safely.

Local Doc Anchors

• godot-docs/tutorials/export/exporting_projects.rst
• godot-docs/tutorials/export/feature_tags.rst
• godot-docs/tutorials/platform/index.rst
• godot-docs/tutorials/export/exporting_for_dedicated_servers.rst