Skip to main content

Changelog

2026-05-17 (second pass)

  • Removed entire API Reference section. Marteso does not have a public API. Deleted api/overview.md, api/authentication.md, api/endpoints.md and removed the API Reference sidebar category.
  • Fixed connect-app.md. Removed the nonexistent "primary country" selection step — adding a project imports directly from App Store Connect with no storefront selection prompt.
  • Rewrote screenshot-automation.md as Build automation. The guide now accurately describes Marteso's actual feature: connecting a GitHub repository so Marteso automatically builds your IPA and generates screenshots on every push. Previous content described a manual screenshot workflow that doesn't exist in the product.
  • Fixed localization.md. Updated storefront prioritization worksheet to point to Marteso's Analytics → Countries tab (which does exist) instead of App Store Connect. Updated the review workflow to use Versions page for editing and Push Metadata for submission.
  • Fixed ai-metadata.md. Added Approve / Reject / Push to ASC workflow documentation.
  • Updated overview.md. Capabilities table now reflects actual product features (Analytics, Build automation, Monetization) and removes the API Reference entry.
  • Retook localization screenshot. localization-country-filter.png now shows Analytics → Countries tab with actual download-by-country data.
  • Added App Settings screenshot. screenshot-management-overview.png now shows the actual App Settings page with GitHub repository link and iOS code signing configuration.

2026-05-17

  • Removed GitHub integration guide. The GitHub integration feature is not yet available. Removed the guide page, all cross-references, and the GitHub integration troubleshooting section.
  • Fixed non-existent feature references across all pages. Removed references to Metadata → Screenshots (no such UI view), rank alerts, Analytics → Downloads by country (analytics is aggregate-only), and Settings → Team per-app permissions.
  • Removed placeholder FAQ entries. Removed two internal staging notes that were mistakenly published as user-facing FAQ content.
  • Fixed analytics API response schema. Field names in the endpoint documentation now match the actual API response (totalDownloads, totalProceedsUsd, totalImpressions, etc.). Added missing avgRating and totalReviews fields.
  • Fixed apps list API response. Added missing isOwnApp and iconUrl fields.
  • Removed screenshot TODO comments. Removed <!-- TODO: screenshot --> markers from all guides. Screenshot image files are present but need replacement with live screenshots.

2026-05-16

  • Full content rewrite across all 13 documentation pages. Removed all "Planned additions" and "Expected content" placeholder sections.
  • Getting Started: Expanded overview with capability table and recommended first path. Added full step-by-step guides for connecting an app (lookup, storefront selection, team access, sync timing) and adding first keywords (seed terms, country selection, rank update timing, groups).
  • Guides: Added complete workflow guides for keyword research (workflow, example table with real data, review cadence), AI metadata (field-by-field examples for title/subtitle/keyword field/description, review rubric, release readout template), screenshot automation (checklist, storefront coverage table, release handoff template), and localization (prioritization worksheet, per-market checklist, high-signal market table).
  • API Reference: Added API overview with base URL, endpoint catalog, error handling reference, and rate limit table. Added full authentication guide covering key creation, request headers, environment separation, key rotation, and secure storage patterns. Added endpoint catalog with request/response examples for apps, keywords, rankings, suggestions, and analytics.
  • Reference: Added troubleshooting guide covering app connection issues, keyword sync timing, rank movement after metadata updates, and AI suggestion issues with support escalation path.

2026-05-15

  • Created the Docusaurus documentation site structure.
  • Added Marteso brand styling, logo, light mode, and dark mode.
  • Added starter sections for Getting Started, Guides, API Reference, and Reference.