Index of every page on this site: llms.txt
All skills
esri avatar

/build-with-arcgis-maps-sdk-for-flutter

@b6fcac5
Run it yourself

Use this skill to build, extend, debug, and explain native iOS and Android apps with ArcGIS Maps SDK for Flutter. Guide SDK setup, authentication, maps and scenes, layers, location, offline workflows, and optional Toolkit widgets.

Use this Skill: https://skilld.dev/gh/esri/esri-developer-agent-skills/build-with-arcgis-maps-sdk-for-flutter

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈68 tokens for metadata: the name and description. ≈1.8k when used: this file.

Description uses 3.4% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈271 characters, or 3.4%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Build with ArcGIS Maps SDK for Flutter

ArcGIS Maps SDK for Flutter builds native iOS and Android apps with 2D/3D maps and spatial capabilities.

Flutter does not yet include every Native Maps SDK capability; verify API availability before relying on a feature.

Before building a new app, clarify its target platform, SDK version, ArcGIS product, and access or authentication requirements.

Application requirements

If the application's development requirements are unclear, use the gather-arcgis-application-requirements skill to review project context and clarify consequential unknowns before proceeding. Then apply this skill's technology-specific guidance, reusing requirements already clear from the request or project.

ArcGIS account requirements

Developers must have one of the following ArcGIS accounts to create applications: ArcGIS Location Platform (free), or ArcGIS Online or ArcGIS Enterprise with a Creator, Professional, or Professional Plus user type. The account's user type, role, and privileges provide access to different resources and operations.

Authentication

DO NOT SKIP: Refer to the follow-arcgis-authentication-patterns skill for ArcGIS authentication requirements, including the appropriate type of authentication for different audiences, use cases, and types of application. If the skill is not available, search the project for any existing authentication patterns, and if none are found, query the Esri MCP server for developer documentation for authentication best practices.

Before implementing or changing authentication, consult the selected SDK version's authentication guidance and applicable native-platform setup sections. For OAuth, verify consistency between the application's OAuth registration, SDK configuration, and required native callback configuration.

Installation and setup

Check the ArcGIS Maps SDK for Flutter system requirements and installation instructions for the selected SDK version and target platform. Follow the authoritative documentation rather than relying on a local summary of setup steps.

For iOS, query the ArcGIS SDK setup or migration instructions appropriate to the existing project and SDK version. If search results omit required steps, consult the exact new iOS applications or migration section. Preserve custom project configuration when applying setup or migration instructions.

Use optional Toolkit widgets when they suit the requested experience.

How to query documentation

Installing this skill individually does not configure Esri MCP server for developer documentation (esri-mcp-server-for-developer-documentation). Add that server at https://developers-mcp.arcgis.com/mcp using your client's MCP settings, or install the full ArcGIS SDKs and APIs plugin (arcgis-sdks-and-apis-plugin). If the MCP server is unavailable, consult the linked official Esri documentation.

Documentation can be queried using the Esri MCP server for developer documentation (esri-mcp-server-for-developer-documentation):

https://developers-mcp.arcgis.com/mcp

Use the search_esri_developer_docs tool to surface authoritative documentation pages with flutter-sdk as the focus_area parameter in addition to a specified search_term. Use the fetch_esri_developer_docs tool with the page_url parameter set to return the full content of a documentation page in Markdown format.

Clearly indicate any recommendations and assumptions that are not grounded in the official documentation. If the MCP server is unavailable, consult official documentation URLs below.

Documentation links

Patterns and guidelines

  • Give each ArcGISMapView, ArcGISSceneView, or ArcGISLocalSceneView its own controller via controllerProvider; configure it in the corresponding onMapViewReady, onSceneViewReady, or onLocalSceneViewReady callback.
  • Await load() on Loadable resources before reading metadata. Check load status and errors, handle failures, retry with retryLoad(), and use cancelLoad() carefully for shared resources. Keep loading and error states visible to app users.
  • Prefer suitable Toolkit widgets and use only APIs available in the selected Flutter SDK release; do not assume APIs from other Native Maps SDKs are available.

Validation process

  • Run the app on the target platform and confirm the requested map or scene workflow renders and behaves as expected.
  • For secured resources, confirm authentication and access work without exposing credentials or tokens.
  • For browser-based authentication, exercise the browser-to-app round trip on each target platform and confirm authentication completes. A successful build does not validate authentication; explicitly report any platform's callback flow that remains unverified.
  • Exercise relevant loading and error states, and test offline behavior when the workflow requires it.
  • Summarize what you verified and disclose meaningful limitations or checks you could not run. Explain SDK or version constraints when they affect the implementation.

New application

  1. Confirm the target platform, SDK version, ArcGIS product, authentication needs, and requested map or scene workflow.
  2. Check the system requirements, create the Flutter app, add arcgis_maps, and configure the required platform settings.
  3. Implement the requested workflow, including appropriate authentication and visible loading and error states.
  4. Run the app on the target platform and verify the requested map or scene behavior.

Existing application

  1. Inspect the existing Flutter setup, SDK version, platform configuration, and authentication pattern.
  2. Check compatibility, then add or update the SDK dependency and platform settings while preserving existing project configuration.
  3. Implement the requested workflow within the app's existing structure, including appropriate loading and error handling.
  4. Run the relevant workflow on the target platform and verify the change without regressing existing behavior.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts5d3 checks · Risk SAFE
  • Gen Agent Trust Hub7d

    This skill provides instructions for developing mobile applications using the ArcGIS Maps SDK for Flutter. It correctly utilizes official Esri documentation services and emphasizes secure authentication and resource loading practices.

  • Socket5d

    No alerts

  • Snyk7d

    Risk: LOW · No issues

Signed by skilld at b6fcac5. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 4 days ago.

Activeupdated last week

README badge

README badge for esri/esri-developer-agent-skills/build-with-arcgis-maps-sdk-for-flutter