umbraco

umbraco

Professional software vendor delivering innovative solutions on the Softono platform. Specialized in both open-source and proprietary software development.

Open Source

# [Umbraco CMS](https://umbraco.com) [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](../LICENSE.md) [![NuGet Version](https://img.shields.io/nuget/v/Umbraco.Cms)](https://www.nuget.org/packages/Umbraco.Cms) [![Build status](https://img.shields.io/azure-devops/build/umbraco/Umbraco%2520Cms/301?logo=azurepipelines&label=Azure%20Pipelines)](https://umbraco.visualstudio.com/Umbraco%20Cms/_build?definitionId=301) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md) [![Forum](https://img.shields.io/badge/help-forum-blue)](https://forum.umbraco.com) [![Chat about Umbraco on Discord](https://img.shields.io/discord/869656431308189746?logo=discord&logoColor=fff)](https://discord.gg/umbraco) ![Mastodon Follow](https://img.shields.io/mastodon/follow/110661369750014952?domain=https%3A%2F%2Fumbracocommunity.social) ### Umbraco is a free and open source .NET content management system. Our mission is to help you deliver delightful digital experiences by making Umbraco friendly, simpler and social. Learn more at [umbraco.com](https://umbraco.com) <p align="center"> <img src="img/logo.png" alt="Umbraco Logo" /> </p> ## <a name="install"></a>Looking to install Umbraco? You can get started using the following commands on Windows, Linux and MacOS (after installing the [.NET Runtime and SDK](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/requirements)): ``` dotnet new install Umbraco.Templates dotnet new umbraco --name MyProject cd MyProject dotnet run ``` ## Documentation Our [comprehensive documentation](https://docs.umbraco.com/umbraco-cms) takes you from the fundamentals on how to start with Umbraco to deploying it to production. Some important documentation links to get you started: - [Installing Umbraco CMS](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install) - [Getting to know Umbraco](https://docs.umbraco.com/umbraco-cms/fundamentals/get-to-know-umbraco) - [Tutorials for creating a basic website and customizing the editing experience](https://docs.umbraco.com/umbraco-cms/tutorials/overview) ## Backoffice Preview Want to see the latest backoffice UI in action? Check out our live preview: **[backofficepreview.umbraco.com](https://backofficepreview.umbraco.com/)** This preview is automatically deployed from the main branch and showcases the latest backoffice features and improvements. It runs from mock data and persistent edits are not supported. ## Get help If you need a bit of feedback while building your Umbraco projects, we are [chatty on Discord](https://discord.umbraco.com). Our Discord server serves as a social space for all Umbracians. If you have any questions or need some help with a problem, head over to our [dedicated forum](https://forum.umbraco.com/) where the Umbraco Community will be happy to help. ## Looking to contribute back to Umbraco? You came to the right place! Our GitHub repository is available for all kinds of contributions: - [Create a bug report](https://github.com/umbraco/Umbraco-CMS/issues) - [Create a feature request](https://github.com/umbraco/Umbraco-CMS/discussions) Umbraco is contribution-focused and community-driven. If you want to contribute back to the Umbraco source code, please check out our [guide to contributing](CONTRIBUTING.md). ### Tip: You should not run Umbraco from source code found here. Umbraco is extremely extensible and can do whatever you need. Instead, [install Umbraco as noted above](#looking-to-install-umbraco) and then [extend it any way you want to](https://docs.umbraco.com/umbraco-cms/extending/).

Traditional CMS

5.2K Github Stars

Open Source

Umbraco.UI

![UI Library](docs/images/UI.png) # [Umbraco UI Library](https://uui.umbraco.com/) [![Build](https://github.com/umbraco/Umbraco.UI/actions/workflows/tests.yml/badge.svg)](https://github.com/umbraco/Umbraco.UI/actions/workflows/tests.yml) [![Storybook build](https://github.com/umbraco/Umbraco.UI/actions/workflows/azure-static-web-apps-delightful-beach-055ecb503.yml/badge.svg)](https://github.com/umbraco/Umbraco.UI/actions/workflows/azure-static-web-apps-delightful-beach-055ecb503.yml) [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=umbraco_Umbraco.UI&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=umbraco_Umbraco.UI) [![npm](https://img.shields.io/npm/v/@umbraco-ui/uui?logoColor=%231B264F)](https://www.npmjs.com/package/@umbraco-ui/uui) [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md) A collection of 80+ web components for building [Umbraco CMS](https://umbraco.com/) interfaces. Built with [Lit](https://lit.dev/) and TypeScript. Browse them in the [Storybook](https://uui.umbraco.com/). ## Installation ```sh npm install @umbraco-ui/uui ``` **Requirements:** Node >= 24.13, npm >= 11. Runtime dependency: [Lit](https://lit.dev/) ^3.0.0. ## Quick start Import only the components you need — your bundler will tree-shake the rest: ```js import '@umbraco-ui/uui/components/button/button.js'; import '@umbraco-ui/uui/components/input/input.js'; ``` ```html <uui-button look="primary" label="Save"></uui-button> <uui-input label="Name"></uui-input> ``` Or register everything at once with `import '@umbraco-ui/uui';`. Include a theme for CSS custom properties and typography: ```html <link rel="stylesheet" href="node_modules/@umbraco-ui/uui/dist/themes/light.css" /> ``` Apply the `uui-font` and `uui-text` classes to the element that should carry UUI typography (typically `<body>`): ```html <body class="uui-font uui-text"> ... </body> ``` No bundler? Use UUI directly in the browser via [import maps](docs/USAGE-WITHOUT-BUNDLER.md). ## Components 80+ components across 13 categories: Buttons, Inputs, Color, Cards, Refs, Feedback, Layout, Forms, Navigation, Icons, Files, Symbols, and Data. Each component has its own README in [`src/components/{name}/`](src/components/). - [Browse in Storybook](https://uui.umbraco.com/) - [Full component list](docs/COMPONENTS.md) ## Documentation See [docs/](docs/) for the full documentation index. ## Development ### Setup Requires Node.js >= 24.13 (see `.nvmrc`) and npm >= 11. ```sh git clone https://github.com/umbraco/Umbraco.UI.git cd Umbraco.UI npm install ``` ### Key commands | Command | Description | | ---------------------------------- | -------------------------------------------------- | | `npm run storybook` | Start Storybook dev server on port 6006 | | `npm run build` | Build the library (Vite + TypeScript declarations) | | `npm run test` | Run all tests with coverage | | `npm run test:coverage-for button` | Run tests for a single component | | `npm run lint` | Lint with ESLint | | `npm run format` | Auto-fix lint and formatting | See [docs/SCRIPTS.md](docs/SCRIPTS.md) for the full list. ### Project structure ``` src/ ├── internal/ # Mixins, events, types, registration ├── styles/ # CSS custom properties and text styles ├── themes/ # Light and dark theme CSS ├── components/ # 80+ component directories └── index.ts # Barrel — re-exports everything ``` ### Branching model - **`main`** — development branch, PR target ([storybook](https://delightful-beach-055ecb503-main.westeurope.azurestaticapps.net/)) - **`production`** — published release, serves Storybook at [uui.umbraco.com](https://uui.umbraco.com) - **`release/*`** — intermediary releases (RCs) ## Contributing Pull requests and stars are always welcome. Read the [contributing guide](docs/CONTRIBUTING.md) to get started. Report bugs and feature requests in the [issue tracker](https://github.com/umbraco/Umbraco.UI/issues). ## License [MIT](LICENSE.md)

CMS Plugins & Extensions Web Components & Widgets

148 Github Stars

umbraco

Software by umbraco

Umbraco

Umbraco.UI