Skip to content

docs: fcode-ama updates for the App console reorganization - #20

Merged
marcos-muino-garcia merged 3 commits into
mainfrom
feature/fcode-ama-ui-reorg
Aug 17, 2026
Merged

docs: fcode-ama updates for the App console reorganization#20
marcos-muino-garcia merged 3 commits into
mainfrom
feature/fcode-ama-ui-reorg

Conversation

@marcos-muino-garcia

Copy link
Copy Markdown
Collaborator

What

Updates fcode-ama (and the fcode-cli clone pointer) for the App console reorganization — each concern now lives in one place:

  • OAuth moved to App settings → OAuth tab (requested scopes, then the development and production credentials). The Getting started checklist and the Dev Marketplace's "Configure dev OAuth" link there; the Internal/Partner/IC callouts and troubleshooting entries now point at the new location, with a "where did the OAuth section go?" entry for users who knew the old layout.
  • App settings → Configuration absorbs marketplace visibility and lifecycle — private-app visibility is now documented there instead of on the Publication tab.
  • Development tab shows the dev workspace and the "How to build locally" guide (the clone-command references now name that section); Production tab adds releases. The installations tables are replaced by counts linking to the pre-filtered Installations page.
  • Dev Marketplace app page links each installed company's deploy- workspace (execution logs, variables, schedules, webhooks) beside the company selector.
  • Installation page "End user actions" removed — user-facing forms run from the (Dev) Marketplace app page; troubleshooting entries added for all the moved/removed surfaces.

Also adds a .gitignore for .DS_Store.

Validation

npx skills-ref validate passes for fcode-ama and fcode-cli.

🤖 Generated with Claude Code

marcos-muino-garcia and others added 3 commits August 17, 2026 08:57
Each concern now lives in one place:
- OAuth moved to App settings -> OAuth tab (requested scopes + dev/prod
  credentials); checklist and Dev Marketplace "Configure dev OAuth" link
  there
- App settings Configuration absorbs marketplace visibility (private
  apps) and lifecycle
- Development tab: dev workspace + "How to build locally" guide;
  Production tab adds releases; installations tables replaced by counts
  linking to the filtered Installations page
- Dev Marketplace app page links each installed company's deploy-
  workspace (logs, variables, schedules, webhooks)
- Installation page "End user actions" removed - the marketplace covers
  that flow

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Developers can copy any deploy- workspace's FACTORIAL_TOKEN from the
installation's "..." menu — on the Installations page (with Suspend) and
on the Dev Marketplace app page (with Re-install / Uninstall) — to run
processes locally in that company's context. Journey + troubleshooting
surface in fcode-ama; procedure extended in its owner, fcode-cli.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Global OAuth apps (created from the Factorial Backoffice) work across
companies; company-scoped ones (created from /oauth/applications) only
authorize their own company. Documented in journey stage 4 and as a
troubleshooting entry for "OAuth works for one company but fails for
others".

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@marcos-muino-garcia
marcos-muino-garcia merged commit b9b8349 into main Aug 17, 2026
1 check passed
@marcos-muino-garcia
marcos-muino-garcia deleted the feature/fcode-ama-ui-reorg branch August 17, 2026 13:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant