@muenchen/appswitcher-vue

appswitcher-vue

Provides a Vue.js/Vuetify component to quickly switch between apps provided by an appswitcher-server instance.

Usage

Installation

npm install @muenchen/appswitcher-vue

Required Peer Dependencies:

"vue": "^3.5.0",
"vuetify": "^4.1.0"

If you are using older versions of Vue.js and Vuetify, you still can use older releases:

Use

import { AppSwitcher } from "@muenchen/appswitcher-vue";

export default {
  name: "MyApp",
  components: {
    AppSwitcher
  }
});

<template>
  <v-app id="app">
    <v-app-bar id="app-bar" app clipped-left dark color="primary">
      <!-- [....] -->
      <v-spacer />
      <app-switcher base-url="https://my-appswitcher-server-instance.example.com" :tags="['global', 'finance']"/>
  </v-app>
</template>

Props

Slots

activator

Default:

<v-icon-btn v-bind="{ ...props, ...$attrs }" :icon="icon" />

Custom example:

<app-switcher
  base-url="https://my-appswitcher-server-instance.example.com"
  :tags="['global', 'finance']"
>
  <template #activator="{ props }">
    <v-btn v-bind="props">CUSTOM activator</v-btn>
  </template>
</app-switcher>

Develop

It is recommended to run a local instance of appswitcher-server as a "backend", e.g. using Docker:

docker run -d --name appswitcher-server -p 8080:8080 -e SPRING_PROFILES_ACTIVE=demo ghcr.io/it-at-m/appswitcher-server:latest

# Do dev stuff
npm run dev

Build

# Run build process
npm run build

Release & Publish

This project uses semantic-release!

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please open an issue with the tag "enhancement", fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Open an issue with the tag "enhancement"
2. Fork the Project
3. Create your Feature Branch (git checkout -b feature/AmazingFeature)
4. Commit your Changes (git commit -m 'Add some AmazingFeature')
5. Push to the Branch (git push origin feature/AmazingFeature)
6. Open a Pull Request

License

Distributed under the MIT License. See LICENSE file for more information.

Contact

it@M - opensource@muenchen.de