Skip to main content

INVENT Platform Documentation

Welcome to the INVENT Experience Builder platform documentation. This guide will help you navigate the documentation based on your role and goals.


Quick Start by Role

🎯 I'm a Widget Developer

New to the platform? Start here:

  1. Prerequisites - Set up your development environment
  2. Create Your First Widget - Step-by-step guide with screenshots
  3. Creating a Widget Tutorial - Complete development guide

Already familiar? Jump to:

🏗️ I'm a Platform Developer

Building platform-level features:

  1. System Overview - Architecture overview
  2. Experience Builder Overview - Platform components
  3. Platform Widgets - Creating platform widgets
  4. BFF Specification - Backend for Frontend API

👨‍💼 I'm a Tech Lead / Architect

Understanding the platform:

  1. INVENT Cloud Platform - High-level platform overview
  2. System Overview - Detailed architecture
  3. Module Federation - Widget loading architecture
  4. Extensions - Extending platform functionality

🆕 I'm Onboarding to the Team

Complete onboarding checklist:

  1. FE Onboarding - Complete onboarding guide
  2. Prerequisites - Development environment setup
  3. Creating Your First Widget - Hands-on tutorial

Quick Navigation by Task

Creating & Publishing Widgets

TaskDocumentation
Create widget from templateFrom Template Tutorial
Understand widget structureGetting Started → Project Structure
Configure widget settingsConfiguration
Publish widget to portalWidget Publishing Flow
Deploy widgetDeployment

Developing Widgets

TaskDocumentation
Run widget locallyDevelopment Workflow → Local Development
Connect to portal for debuggingDevelopment Workflow → Connecting to Portal
Call APIs from widgetCore Features → API Integration
Add OAuth authenticationAdvanced Features → OAuth
Share data between widgetsAdvanced Features → State Sharing
Add WebSocket updatesAdvanced Features → WebSocket

Widget Features & APIs

TaskDocumentation
Use platform APIsWidget Specifications API
Display notificationsCore Features → Notifications
Apply themingConfiguration → Theming
Create settings formConfiguration → Widget Settings
Use UI-Kit componentsUI-Kit

Testing & Quality

TaskDocumentation
Write component testsLayout & Testing → Testing
Ensure accessibilityA11y Support
Code style & lintingCode Style
Version managementSemantic Versioning

Platform Integration

TaskDocumentation
Understand widget typesDashboard Integration → Widget Types
Work with Dashboard ComposerDashboard Integration
Use extensionsExtensions
Understand Module FederationModule Federation

Documentation Sections

📚 Creating a Widget

Complete tutorial covering widget development from start to finish:

  • Getting Started & Setup
  • Dashboard Integration
  • Configuration & Theming
  • Core Features (API, Notifications, React Query)
  • Layout & Testing
  • Development Workflow
  • Deployment
  • Advanced Features (OAuth, State Sharing, WebSockets)

🚀 Quickstart Guides

Step-by-step guides for getting started:

  • Prerequisites & Environment Setup
  • Creating Widget from Template (5 steps)
  • Creating Widget from Existing Widget

📖 Manual

Comprehensive reference documentation:

  • Guidelines - Widget development patterns and best practices
  • BFF - Backend for Frontend specification
  • Extensions - Platform extensions system
  • UI-Kit - Component library
  • Widget Store - Widget distribution
  • Theming - Platform theming system
  • Technology - Module Federation, versioning
  • Reference - Environment variables, browser testing, PR decoration

🌐 Overview

Platform architecture and concepts:

  • Platform Overview & Terminology
  • Experience Builder Architecture
  • INVENT Cloud Platform
  • System Overview

🎓 Tutorials

Hands-on tutorials for specific tasks:

  • Merge Request Tutorial
  • Prettier Setup Tutorial
  • ProxyLogin Tutorial