Update Project Metadata
update_project_metadataUpdate project settings; current values appear at the top of list_files. Changes reach the published app at the next publish. Settings marked "on request" change only when the user asks about that subject.
updates (flat keys): title (2-100 chars), description, iconUrl (app icon: favicon, home-screen and native icon; a /_cdn/static/… path from upload_asset, generate_image or request_user_upload, or an https URL; null resets), splashUrl (native splash, same forms), mobileAppId, enableSSR, flootAiDisallowed (true opts out of @floot/ai), iOS Info.plist NS…UsageDescription strings (null removes) and UIViewControllerBasedStatusBarAppearance (boolean, null restores). Invalid keys are reported and skipped. After the first iOS / Android publish, edit static/__dev/native/ios-info.plist or android-manifest.xml instead (get_guides("ios-info-plist"), get_guides("android-manifest")).
shareTarget: native share-sheet target; ship it with the handler in app code (get_guides("share-target")).
nativeSystemBars: 'inset' (default) or 'edge-to-edge', which needs safe-area padding in the app (get_guides("native-system-bars")). ios.scrollEdgeEffect 'hidden' removes the iOS 26+ blur under the status bar.
serverMemoryMb: expert setting, only when the user explicitly asks to change the server memory: too low stops the backend and can cost more (get_guides("server-memory")).
analyticsMode: on request (analytics, cookies, consent; get_guides("analytics")).
iosDeviceFamily: before 'iphone' or 'ipad', ask whether the app is live on the App Store supporting the device it would drop; if it is, it cannot drop it. The only way to make it iPhone-only or iPad-only.
homeScreenName: the name under the installed app's icon (iOS + Android), also after the first mobile publish; keeps the bundle id and store listing names. null = default (store listing title, else project name).
routePrefetch: on request (page prefetching, load performance; get_guides("route-prefetch")).
dependencyOverrides: on request, to fix a vulnerable or conflicting nested package (get_guides("dependency-overrides")).
securityHeaders: on request (iframes, CSP, a security scan, referrer; get_guides("security-headers")). Never in the preview.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "update_project_metadata"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| updates | No | Flat fields (see the description). | |
| projectId | Yes | ||
| shareTarget | No | { enabled: false } removes it. | |
| analyticsMode | No | ||
| routePrefetch | No | Merged over the current value; null restores the default. | |
| homeScreenName | No | ||
| serverMemoryMb | No | Memory (MB) of the project's server Lambda, 512–4096. EXPERT SETTING: only on an explicit user request to change the server memory (see the tool description for the risks); never touch it otherwise. Omit to leave unchanged; null restores the platform default. | |
| iosDeviceFamily | No | ||
| securityHeaders | No | A field passed replaces, null removes, left out is kept. null restores the platform defaults. | |
| nativeSystemBars | No | Replaced whole; android / ios override the top level per platform. { mode: 'inset' } restores the default. | |
| dependencyOverrides | No | { "parent>package": exact or ^/~ version, or null to remove }; the parent is a direct dependency. null removes all. |