π A self-hostable personal dashboard built for you. Includes status-checking, widgets, themes, icon packs, a UI editor and tons more!
Vue awesomedashboarddockerhomelabhomepagemitnodejsorganizationproductivitypwaself-hostedstartpagevue
// Import core framework and essential utils
import { createApp } from 'vue';
// Import component Vue plugins, used throughout the app
import VSelect from 'vue-select'; // Select dropdown component
// Import base Dashy components and utils
import Dashy from '@/App.vue'; // Main Dashy Vue app
import Modal from '@/components/FormElements/Modal.vue'; // In-house modal component
import VModal from '@/plugins/modal'; // $modal.show()/hide() plugin
import store from '@/store'; // Store, for local state management
import router from '@/router'; // Router, for navigation
import serviceWorker from '@/utils/InitServiceWorker'; // Service worker initialization
import i18n from '@/utils/i18n'; // i18n instance (exported so non-component callers can t())
import ErrorReporting from '@/utils/logging/ErrorReporting'; // Error reporting initializer (off)
import clickOutside from '@/directives/ClickOutside'; // Directive for closing popups, modals, etc
import tooltip from '@/directives/Tooltip'; // Custom tooltip directive
import dragSort from '@/directives/DragSort'; // Drag-and-drop list sorting directive
import { initKeycloakAuth, isKeycloakEnabled } from '@/utils/auth/KeycloakAuth';
import { initHeaderAuth, isHeaderAuthEnabled } from '@/utils/auth/HeaderAuth';
import { initOidcAuth, isOidcEnabled, isOidcLoginPageEnabled } from '@/utils/auth/OidcAuth';
import { isLoggedIn } from '@/utils/auth/Auth';
import { loadExternalStyleSheets } from '@/utils/Theming';
import Keys from '@/utils/StoreMutations';
import ErrorHandler from '@/utils/logging/ErrorHandler';
import Toast from '@/utils/Toast';
// Create the Vue 3 app instance
const app = createApp(Dashy);
// Register plugins
app.use(store);
app.use(router);
app.use(i18n);
app.use(VModal);
app.use(Toast);
// Register global components and directives
app.component('modal', Modal);
app.component('v-select', VSelect);
app.directive('clickOutside', clickOutside);
app.directive('tooltip', tooltip);
app.directive('dragSort', dragSort);
app.config.errorHandler = (err, instance, info) => {
ErrorHandler(`Vue error in ${info}`, err);
};
window.addEventListener('unhandledrejection', (event) => {
ErrorHandler('Unhandled promise rejection', event.reason);
});
const isDevMode = import.meta.env.DEV;
app.config.performance = isDevMode;
serviceWorker();
// Checks if user enabled error reporting, and if so will initialize it
ErrorReporting(app, router);
// Mount the app, once any external stylesheets are ready
const mount = () => {
loadExternalStyleSheets(store.getters.appConfig)
.finally(() => app.mount('#app'));
};
/* Handle failures of third-party auth initialization */
const handleAuthFailure = (provider, err) => {
ErrorHandler(`Failed to authenticate with ${provider}`, err);
store.commit(Keys.CRITICAL_ERROR_MSG, `Authentication failed (${provider}).`);
router.replace({ name: 'login' }).catch(() => {}).finally(mount);
};
/* With OIDC set to show the login page, signed-out users are sent there before mounting */
const needsOidcLoginPage = () => isOidcLoginPageEnabled() && !isLoggedIn()
&& router.currentRoute.value.name !== 'login';
/* An alias redirect aborts the first navigation on purpose, anything else should still render */
const handleAbortedNavigation = (failure) => {
if (failure?.to?.name === 'alias') return;
ErrorHandler('Initial navigation failed', failure);
router.replace({ name: '404' }).catch(() => {}).finally(mount);
};
router.isReady().then(() => {
if (isOidcEnabled()) {
const requestedUrl = router.currentRoute.value.redirectedFrom?.href;
initOidcAuth(requestedUrl).then((reloading) => {
if (reloading) return;
if (needsOidcLoginPage()) {
router.replace({ name: 'login' }).catch(() => { }).finally(mount);
}
else {
mount();
}
}).catch((e) => handleAuthFailure('OIDC', e));
} else if (isKeycloakEnabled()) {
initKeycloakAuth().then(mount).catch((e) => handleAuthFailure('Keycloak', e));
} else if (isHeaderAuthEnabled()) {
initHeaderAuth().then(mount).catch((e) => handleAuthFailure('Header Auth', e));
} else {
mount();
}
}, handleAbortedNavigation);