Skip to main content

Introduction

OpenComponents is a language-agnostic micro frontend framework: it lets independent teams build, publish, and version UI components as isomorphic HTML/CSS/JS bundles, and lets any backend (Node.js, .NET, PHP, Java, Go, ...) render and consume them over a simple HTTP + HTML contract.

New to the project? Read Why OpenComponents? for the motivation, or jump straight into the Quick Start Tutorial to build your first component.

The pieces

  • Component – a small, versioned bundle of view + optional server logic. See Building Components.
  • Registry – the REST API that stores, versions, and serves components. See Registry Configuration.
  • Library – the storage backend (S3, Google Cloud Storage, Azure, ...) the registry uses to persist published components.
  • Client – the browser/Node.js/PHP/Ruby runtime that discovers and renders components. See Consuming Components.

30-second start

# Install the CLI
npm install -g oc

# Create your first component
oc init my-component

# Start a local dev registry and preview it
oc dev . 3030
open http://localhost:3030/my-component/~preview

For the full walkthrough — creating, developing, publishing, and consuming a component — see the Quick Start Tutorial.

Where to go next

I want to...Go to
Understand why OC exists and when to use itWhy OpenComponents?
See how the pieces fit togetherArchitecture Overview
Build a componentBuilding Components
Consume components in an appConsuming Components
Set up a registryRegistry Configuration
Find answers to common questionsFAQ