Skip to content

tmarois/galaxy-vue

Repository files navigation

galaxy-vue

Install Locally

Install the package locally npm ci or npm install

Build Package

This will compile new dist code npm run build:package

View Examples

View the documentation/example components npm run dev

Install Within Your Project

Until there is a proper npm package to install from, you an do:

github:tmarois/galaxy-vue#main

When changes are made, you can do:

npm update galaxy-vue

Note: There will be a package soon for the first version. This is currently in testing phase.

Import

Be sure to globally add the css into your project

import '/node_modules/galaxy-vue/dist/style.css';

Importing components

import { Button } from 'galaxy-vue'

Variants

Variants allow you to override existing default classes or create your own from scratch. You don't have to replace all the variant properties, only the ones you wish to change (usually to customize the colors). If you don't use all the properties from the default variant, it will automatically use the default variant properties in its place.

You can override or add new variants using:

import { setVariantClasses } from 'galaxy-vue'

setVariantClasses({
    'Button': {
        cta: {
            base: 'whitespace-nowrap font-medium rounded-full border cursor-pointer',
            baseSize: 'text-lg px-8 py-4',
            normal: 'text-white bg-brand hover:bg-brandLite border-transparent',
        },
        // ... more variants for the button
    },
    // ... more components 
)

Note: it would be best to set this globally in your package like a set of rules.

Using Nuxt3 Plugins you can do:

import { setVariantClasses } from 'galaxy-vue'
import '/node_modules/galaxy-vue/dist/style.css';

export default defineNuxtPlugin(() => {
    setVariantClasses({
        'Button': {
            cta: {
                base: 'whitespace-nowrap font-medium rounded-full border cursor-pointer',
                baseSize: 'text-lg px-8 py-4',
                normal: 'text-white bg-brand hover:bg-brandLite border-transparent',
            },
            // ... more variants for the button
        },
        // ... more components 
    })
})

In the examples above, you can use variants like

<Button variant="cta">Sign Up</Button>