October 16, 2025 - Enhanced Codex information architecture and developer experience

Cumulocity Change Log Application Enablement
, ,
1

Context

Change Type: Feature
Product area: Application enablement & solutions
Component: Web SDK
Deployed at: eu.latest.cumulocity.com, apj.cumulocity.com, jp.cumulocity.com, cumulocity.com, us.cumulocity.com, emea.cumulocity.com

Technical details

Build artifact: ui-c8y (1022.36.0)
Internal ID: MTM-64747

Description

The Developer Codex has been redesigned with a clearer information architecture, offering step-by-step guides, core concepts, design best practices, and complete Web SDK documentation in a more discoverable and structured format. Whether you’re new to Cumulocity or an experienced developer, you’ll find faster paths to building effective IoT solutions, understanding platform architecture, designing better UIs, and connecting with the developer community.

The Developer Codes now includes

  • Simplified navigation – Reduced menu depth and introduced an intuitive 2–3 level, card-based structure for faster and easier content discovery.
  • Learning-oriented structure – Content is now organized to support a natural learning journey from fundamentals to advanced implementation:
    • First steps (formerly Quick start) – Get up and running quickly
    • Understanding fundamentals (formerly Core concepts) – Learn the platform architecture
    • Hands-on learning (formerly Common tasks) – Practice through real-world examples
    • Building UIs – Explore components and design system resources
    • Platform integration – Dive into advanced development and complex scenarios
  • Enhanced cross-references – Stronger linking between related topics to support knowledge building and continuous learning
  • Optimized learning flow – A progressive content structure that guides developers smoothly from beginner to expert level

See Cumulocity Developer Codex.

2

Hi there,

first of all: Awesome!

Second of all, there is still a bunch of missing stuff in there, but having a good WIP is better than having nothing :slight_smile:

Most importantly, there seems to be something missing on the [Your first application / Codex] page, as this:

  • A scaffolded Cumulocity application based on cockpit - this guide will show you how to create one.

isn’t actually shown.

3

Hi Christoph,

thank you for the feedback, I will forward it to the documentation team. In general, it would be great if you can also use the Feedback button in the documentation to provide improvement suggestions:

Screenshot 2025-10-23 at 09.03.11

This is available across our documentation and ensures that the feedback reaches the documentation team and they have the necessary context to understand it.

4

To be honest, I completely missed that button :smiley: