@codemonster-ru/vueforge-core

Stable foundation layer for the VueForge design system.

Current scope

Version 1.3.0 focuses on:

• Vue 3 library build with Vite
• TypeScript declarations
• Vitest + Vue Test Utils
• Theme provider and useTheme
• CSS design tokens and theme variables
• Built-in default theme preset powered by the shared @codemonster-ru/vueforge-theme engine

Installation

import { createApp } from "vue";
import VueForge from "@codemonster-ru/vueforge-core";

const app = createApp(App);

app.use(VueForge);

Theme Overrides

import { createApp } from "vue";
import VueForge, { defaultThemePreset } from "@codemonster-ru/vueforge-core";

const app = createApp(App);

app.use(VueForge, {
  theme: {
    preset: defaultThemePreset,
    extend: {
      colorPrimary: "#ff5a36",
    },
  },
});

For the full theme runtime and preset API, see Theme API.

Theme Architecture

VueForge now has two theme layers:

• @codemonster-ru/vueforge-theme
  • neutral theme engine
  • token and preset types
  • preset resolution and CSS variable serialization
  • mode helpers and shared motion tokens
• @codemonster-ru/vueforge-core
  • built-in defaultThemePreset
  • Vue plugin and VfThemeProvider
  • component library and package CSS

This means vueforge-core is still the easiest way to consume the default VueForge design language, while higher-level packages can share the same engine without depending on core runtime helpers.

Foundation Usage

Use the full package when you need VueForge components, styles, and theme runtime together.

import VueForge from "@codemonster-ru/vueforge-core";

Use foundation-only entry points when another package, such as vueforge-layouts, needs shared responsive or platform helpers without depending on the full UI surface.

import {
  vfBreakpoints,
  useBreakpoint,
  useBreakpoints,
  useBreakpointValue,
  useScrollLock,
} from "@codemonster-ru/vueforge-core/foundation";

Available subpaths:

• @codemonster-ru/vueforge-core
• @codemonster-ru/vueforge-core/styles.css
• @codemonster-ru/vueforge-core/tokens.css
• @codemonster-ru/vueforge-core/foundation.css
• @codemonster-ru/vueforge-core/foundation
• @codemonster-ru/vueforge-core/theme

Stability

• Stable UI API: components exported from the root package
• Stable theme API: VueForge, createVueForge, defaultThemePreset, createThemePreset
• Stable foundation API: breakpoint constants and foundation composables from ./foundation

For the full foundation contract, see Foundation API.

Development

npm install
npm run build
npm run test

Visual Baseline

• Visual Baseline 1.0
• Theme API
• Foundation API
• Overlay API
• Release Checklist

License

MIT

Author

@KolesnikovKirill