Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

440 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CodeMonster UI

CodeMonster UI is a cross-platform design system with shared tokens, CSS, browser behavior, and supported adapters for Vue 3 and Annabel Razor.

CodeMonster UI 1.0

Install the stable Vue packages:

npm install vue@^3.5.0 @codemonster-ru/ui-vue@^1.0.0 @codemonster-ru/ui-css@^1.0.0

Install the stable Annabel Razor package:

composer require codemonster-ru/ui-razor:^1.0.1

See the component documentation, CSS-only guide, and VueForge migration guide.

VueForge maintenance

VueForge design-system foundations are in maintenance. They receive critical security and correctness fixes, but no new component families or design-system foundations. Use CodeMonster UI 1.0 for new shared Vue and Annabel Razor UI work.

Existing VueForge releases remain installable and are not being unpublished. Icons remain supported until a verified replacement exists. CodeBlock and the Playground packages remain separately maintained products and can be used alongside CodeMonster UI.

Requirements

  • Vue ^3.5.0.
  • Node.js 18 or newer for packages other than CodeBlock and Playground. A selected Vite version may impose a higher Node.js requirement on the Playground Vite plugin.
  • Node.js 20 or newer when using CodeBlock or Playground.

Existing VueForge applications

Use the package manager that owns your application lockfile:

npm install vue@^3.5.0 @codemonster-ru/vueforge-core@^2.4.0
pnpm add vue@^3.5.0 @codemonster-ru/vueforge-core@^2.4.0
yarn add vue@^3.5.0 @codemonster-ru/vueforge-core@^2.4.0

Quick start

Install the Core plugin once and import its complete stylesheet in the browser entry:

// src/main.ts
import { createApp } from 'vue';
import VueForgeCore from '@codemonster-ru/vueforge-core';
import '@codemonster-ru/vueforge-core/styles.css';
import App from './App.vue';

createApp(App).use(VueForgeCore).mount('#app');

Wrap themed UI in VfThemeProvider. Components are not registered globally, so import the components used by each application:

<!-- src/App.vue -->
<script setup lang="ts">
import { VfButton, VfThemeProvider, VfThemeSwitch } from '@codemonster-ru/vueforge-core';
</script>

<template>
  <VfThemeProvider default-theme="system">
    <main>
      <VfThemeSwitch label="Theme" />
      <VfButton>First VueForge action</VfButton>
    </main>
  </VfThemeProvider>
</template>

VfThemeSwitch persists the selected light or dark mode through the provider. Build the application with its normal production command—for a standard Vite project:

npm run build

Packages

Package Release Purpose
@codemonster-ru/vueforge-core 2.4.0 Components, composables, theme integration
@codemonster-ru/vueforge-theme 2.0.1 Framework-agnostic theme engine
@codemonster-ru/vueforge-layouts 2.1.2 Layout primitives and application shells
@codemonster-ru/vueforge-icons 3.2.0 Vue icon renderer and catalog
@codemonster-ru/vueforge-codeblock 4.0.1 Highlighted, themed code blocks
@codemonster-ru/vueforge-playground 3.0.1 Vue playground UI adapter
@codemonster-ru/vueforge-playground-core 2.1.0 Framework-agnostic playground runtime
@codemonster-ru/vueforge-playground-vite-plugin 1.0.0 Vite playground virtual-module integration

Documentation

For full documentation, visit docs.codemonster.net/vueforge. Use the VueForge 2 migration guide for breaking changes and the release notes for the coordinated package changes. New applications can adopt CodeMonster UI for shared Vue and Annabel Razor components. Existing applications should use the VueForge to CodeMonster UI migration guide for package and component replacements, retained products, manual migrations, and the deterministic codemod.

License

VueForge packages are available under the MIT License.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages