@codemonster-ru/vueforge-core
v2.4.0
Published
Foundation layer for the VueForge design system.
Maintainers
Readme
VueForge Core
Core Vue 3 components, tokens, and theme runtime for the VueForge ecosystem.
Coordinated release: @codemonster-ru/[email protected].
Requirements
- Node.js 18 or newer for consumer tooling and SSR.
- Vue
^3.5.0.
Install
npm install vue@^3.5.0 @codemonster-ru/vueforge-corepnpm add vue@^3.5.0 @codemonster-ru/vueforge-coreyarn add vue@^3.5.0 @codemonster-ru/vueforge-coreQuick start
The plugin applies the default theme and provides configuration. It does not globally register components.
import { createApp } from 'vue';
import VueForgeCore, { VfButton } from '@codemonster-ru/vueforge-core';
import '@codemonster-ru/vueforge-core/styles.css';
const app = createApp({});
app.use(VueForgeCore);
app.component('VfButton', VfButton);Granular setup
Component subpaths load their matching component CSS in browser builds:
import { createApp } from 'vue';
import VueForgeCore from '@codemonster-ru/vueforge-core';
import { VfButton } from '@codemonster-ru/vueforge-core/button';
import '@codemonster-ru/vueforge-core/tokens.css';
import '@codemonster-ru/vueforge-core/theme.css';
import '@codemonster-ru/vueforge-core/base.css';
createApp({}).use(VueForgeCore);Auto CSS covers component rules; it does not silently import the complete baseline. Use the three
foundation CSS entries above once per application. styles.css is the full stylesheet and includes
every component rule, so it is not a granular alternative to those entries.
For fully manual CSS delivery, import components from the CSS-free package root and add the matching component CSS explicitly. Browser component subpaths always select their auto-CSS wrappers.
import VueForgeCore, { VfButton } from '@codemonster-ru/vueforge-core';
import '@codemonster-ru/vueforge-core/tokens.css';
import '@codemonster-ru/vueforge-core/theme.css';
import '@codemonster-ru/vueforge-core/base.css';
import '@codemonster-ru/vueforge-core/button.css';Public entries
- Root: plugin, components, composables, theme helpers, and public types.
- Components:
./button,./dialog,./menu,./tabs, and the other documented component subpaths. - Runtime utilities:
./foundation,./theme, and./async. - CSS:
./styles.css,./foundation.css,./tokens.css,./theme.css,./base.css, and per-component CSS entries.
The root, foundation, and theme entries support ESM and CommonJS SSR. Node ESM component conditions are CSS-free; browser conditions retain component auto CSS. Import application CSS in the client entry of an SSR application.
More documentation
For full documentation, visit docs.codemonster.net/vueforge/core. Start with the repository installation guide and CHANGELOG.md.
