Apigee X UI vs On-Prem: Flow Visualization & Developer Productivity

Hello Apigee Team & Community,

I have been working with Apigee for more than 5 years across different
environments and use cases, including both Apigee On-Prem and
Apigee X (Cloud). Based on this experience, I would like to share
some feedback specifically related to developer experience and
usability during API proxy development.

From a development and troubleshooting perspective,
Apigee On-Prem offers clearer visibility and stronger control
over API flow execution compared to Apigee X.

:small_blue_diamond: Apigee On-Prem – Developer Experience:

  • Unified and clear visualization of proxy flows.
  • Easier understanding of policy execution order.
  • Better visibility into how requests and responses move through the proxy.
  • Faster debugging and troubleshooting, especially for complex proxies.
  • Reduced cognitive load during development.

:small_blue_diamond: Apigee X – Observed Challenges:

  • Flow visualization feels more fragmented.
  • Harder to quickly understand the full execution path of a request.
  • Requires more navigation and context switching to inspect policy behavior.
  • Reduced visibility impacts developer productivity when working on
    complex logic such as security, authorization, or transformations.

This feedback is focused purely on usability and developer productivity,
not on infrastructure, scalability, or managed-service benefits.
Apigee X is powerful from a platform perspective,
but the current UI/UX makes flow understanding and debugging more difficult
compared to the On-Prem experience.

:light_bulb: Suggestions for Improvement:

  • Provide a unified execution-path view for selected flows.
  • Improve visual representation of policy order and conditions.
  • Introduce a flow-centric debugging or visualization mode.

Enhancing these areas would significantly improve the
day-to-day development experience and ease migration from On-Prem to Apigee X.

I would be interested to hear if others in the community share
similar observations or have best practices to overcome these challenges.

Thank you.

3 Likes

Welcome to the community @Mohamad_Shamia, wishing you a happy new year in advance!

It’s great to have an expert like you sharing your insights.

Thank you for this thoughtful breakdown. I’ve already passed your feedback to the team and look forward to reading what others share on this topic.

1 Like

Yes, the same. Apigee holds a lot of configurations (and lots of developers not aware or it requires skill to see full picture and configure (for best practice, right), like target servers, fault rules(order and config), 404 handler so no operations will pass unprovisioned), and new canvas (also the old one) based on pure XML + lots of experience or docs to configure. I’m trying to solve this around couple of years and I created local IDE for me with different canvas, no XML, all ui ux based, with autocompletion and proposals for developer, including debug\test in one single screen. I can share some screens or demo if @AlexET can allow it

Agree with the points and suggestions.. @Denis_Kalitviansky has been doing amazing work on add-on UX for proxy designing and debugging, which I hope he can show more of soon as a great option for Apigee users. Also keeping feature proxies small and then merging them into production proxies is an approach that I’ve been working on, see project here: GitHub - apigee/apigee-templater.

1 Like