From d3709ed8525858a5ed0a69c21a259d774c90dec5 Mon Sep 17 00:00:00 2001
From: Janis <janis.e.20@gmx.de>
Date: Tue, 20 Jan 2026 12:28:20 +0100
Subject: [PATCH] feat/auth (#29)

Reviewed-on: https://git.janis-eccarius.de/KnockOutWhist/KnockOutWhist-Frontend/pulls/29
Co-authored-by: Janis <janis.e.20@gmx.de>
Co-committed-by: Janis <janis.e.20@gmx.de>
---
 src/App.vue                         |  73 +---
 src/components/MainMenuBoxes.vue    |  44 ++-
 src/components/User.vue             |  17 +-
 src/composables/useWebsocket.ts     |  20 +-
 src/main.ts                         |  10 +-
 src/router/index.ts                 |  36 +-
 src/views/Game.vue                  |  11 +-
 src/views/LoginView.vue             | 378 ++++++++++++++++----
 src/views/RegisterView.vue          | 516 ++++++++++++++++++++++++++++
 src/views/UsernameSelectionView.vue | 457 ++++++++++++++++++++++++
 10 files changed, 1411 insertions(+), 151 deletions(-)
 create mode 100644 src/views/RegisterView.vue
 create mode 100644 src/views/UsernameSelectionView.vue

diff --git a/src/App.vue b/src/App.vue
index 8ce5497..b06dc33 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -3,10 +3,7 @@ import { RouterView } from 'vue-router'
 import { onMounted, onUnmounted, watch } from 'vue';
 import { useRoute, useRouter } from 'vue-router';
 import { useUserInfo } from "@/composables/useUserInfo";
-import { useIngame } from "@/composables/useIngame";
-import { storeToRefs } from "pinia";
-import { useWebSocket } from "@/composables/useWebsocket";
-import { useQuasar } from "quasar";
+import {Dark } from "quasar";
 
 const route = useRoute();
 const router = useRouter();
@@ -22,15 +19,26 @@ const handleOnlineStatusChange = () => {
 
 let interval: number | null = null;
 
-onMounted(() => {
+onMounted(async () => {
   window.addEventListener('online', handleOnlineStatusChange);
 
+  // Initialize dark mode based on browser preference
+  Dark.set('auto');
+
+  // Immediately check user state on app load
+  if (navigator.onLine) {
+    await info.requestState();
+    if (!info.username && route.meta.requiresAuth) {
+      router.push({ name: '/' });
+    }
+  }
+
   // Continuously check user state every 10 seconds
   interval = window.setInterval(async () => {
-    if (navigator.onLine && route.name !== 'login' && route.name !== 'offline') {
+    if (navigator.onLine) {
       await info.requestState();
-      if (!info.username && route.name !== 'login') {
-        router.push({ name: 'login' });
+      if (!info.username && route.meta.requiresAuth) {
+        router.push({ name: '/' });
       }
     }
   }, 10000);
@@ -48,55 +56,6 @@ watch(() => info.gameId, (newGameId) => {
     router.push({ name: 'game' });
   }
 });
-
-const ig = useIngame()
-const { isWsConnected } = storeToRefs(ig)
-const wb = useWebSocket()
-const $q = useQuasar();
-
-watch(isWsConnected, (connected) => {
-  if (!connected && info.gameId && route.name === 'game') {
-    showReconnectDialog();
-  }
-});
-
-function showReconnectDialog() {
-  $q.dialog({
-    title: 'Connection Lost',
-    message: 'The connection to the game server was lost. Would you like to reconnect?',
-    persistent: true,
-    ok: {
-      label: 'Reconnect',
-      color: 'positive'
-    },
-    cancel: {
-      label: 'Quit',
-      color: 'negative'
-    }
-  }).onOk(() => {
-    reconnect();
-  }).onCancel(() => {
-    router.replace("/");
-  });
-}
-
-async function reconnect() {
-  try {
-    await wb.connect();
-    $q.notify({
-      message: 'Reconnected successfully!',
-      color: 'positive',
-      icon: 'check'
-    });
-  } catch (err) {
-    $q.notify({
-      message: 'Failed to reconnect. Please try again.',
-      color: 'negative',
-      icon: 'error'
-    });
-    showReconnectDialog();
-  }
-}
 </script>
 
 <template>
diff --git a/src/components/MainMenuBoxes.vue b/src/components/MainMenuBoxes.vue
index 68adeac..f4f6c5e 100644
--- a/src/components/MainMenuBoxes.vue
+++ b/src/components/MainMenuBoxes.vue
@@ -1,40 +1,68 @@
 <script setup lang="ts">
 import { useRouter } from 'vue-router';
+import { useUserInfo } from '@/composables/useUserInfo';
+import { useQuasar } from 'quasar';
 
 const router = useRouter();
+const userInfo = useUserInfo();
+const $q = useQuasar();
+
 const menuItems = [
   {
     title: 'Create game',
     description: 'Create a new game and invite your friends to play with you.',
     icon: 'add_circle_outline',
     routeName: 'create-Game',
-    color: 'green-9'
+    color: 'green-9',
+    requiresAuth: true
   },
   {
     title: 'Spiel beitreten',
     description: 'Join a game by typing in the game identifier.',
     icon: 'login',
     routeName: 'join-Game',
-    color: 'blue-9'
+    color: 'blue-9',
+    requiresAuth: true
   },
   {
     title: 'Settings',
     description: 'This area is currently under construction.',
     icon: 'settings',
     routeName: 'settings',
-    color: 'grey-8'
+    color: 'grey-8',
+    requiresAuth: false
   },
   {
     title: 'Rules',
     description: 'Look at the rules to have a clear understanding for playing the game.',
     icon: 'settings',
-    routeName: 'rules-Game',
-    color: 'grey-8'
+    routeName: 'rule-Game',
+    color: 'grey-8',
+    requiresAuth: false
   }
 ];
 
-const navigateTo = (routeName: string) => {
-  router.push({ name: routeName });
+const navigateTo = (item: any) => {
+  if (item.requiresAuth && !userInfo.username) {
+    $q.dialog({
+      title: 'Authentication Required',
+      message: 'You need to be logged in to create or join a game. Would you like to log in or sign up?',
+      ok: {
+        label: 'Login',
+        color: 'primary'
+      },
+      cancel: {
+        label: 'Sign Up',
+        color: 'secondary'
+      }
+    }).onOk(() => {
+      router.push({ name: 'login' });
+    }).onCancel(() => {
+      router.push({ name: 'register' });
+    });
+  } else {
+    router.push({ name: item.routeName });
+  }
 };
 </script>
 
@@ -57,7 +85,7 @@ const navigateTo = (routeName: string) => {
       <q-card
         class="menu-card bg-dark text-white q-pa-sm cursor-pointer"
         v-ripple
-        @click="navigateTo(item.routeName)"
+        @click="navigateTo(item)"
       >
         <q-card-section class="row items-center no-wrap">
           <q-avatar
diff --git a/src/components/User.vue b/src/components/User.vue
index 5f89978..d93e681 100644
--- a/src/components/User.vue
+++ b/src/components/User.vue
@@ -68,8 +68,21 @@ const handleLogoff = () => {
       </q-menu>
     </div>
 
-    <div v-else class="text-caption text-grey-4">
-      Not Logged In
+    <div v-else class="row items-center q-gutter-x-sm">
+      <q-btn
+        flat
+        color="white"
+        label="Login"
+        @click="router.push({ name: 'login' })"
+        size="sm"
+      />
+      <q-btn
+        outline
+        color="white"
+        label="Sign Up"
+        @click="router.push({ name: 'register' })"
+        size="sm"
+      />
     </div>
 
   </div>
diff --git a/src/composables/useWebsocket.ts b/src/composables/useWebsocket.ts
index e66860c..6e660d1 100644
--- a/src/composables/useWebsocket.ts
+++ b/src/composables/useWebsocket.ts
@@ -1,4 +1,4 @@
-import { ref, onMounted, onBeforeUnmount } from "vue";
+import { ref, onMounted, onBeforeUnmount, watch } from "vue";
 import {
   connectWebSocket,
   disconnectWebSocket,
@@ -8,6 +8,7 @@ import {
   isWebSocketConnected,
   setDefaultHandler,
 } from "@/services/ws";
+import { useIngame } from "@/composables/useIngame";
 
 function defaultEventHandler<T = any>(data: (data: T) => void) {
   setDefaultHandler(data);
@@ -16,15 +17,28 @@ function defaultEventHandler<T = any>(data: (data: T) => void) {
 export function useWebSocket() {
   const isConnected = ref(isWebSocketConnected());
   const lastMessage = ref<any>(null);
-
   const lastError = ref<string | null>(null);
+  
+  // Get ingame store to sync connection state
+  const ig = useIngame();
+
+  // Watch the ingame store's connection state and keep this composable in sync
+  watch(() => ig.isWsConnected, (connected) => {
+    isConnected.value = connected;
+  });
+
+  // Also update this composable's state when connecting/disconnecting
+  const updateConnectionState = (connected: boolean) => {
+    isConnected.value = connected;
+  };
 
   async function safeConnect(url?: string) {
     return connectWebSocket(url)
       .then(() => {
-        isConnected.value = true;
+        updateConnectionState(true);
       })
       .catch((err) => {
+        updateConnectionState(false);
         lastError.value = err?.message ?? "Unknown WS error";
         throw err;
       });
diff --git a/src/main.ts b/src/main.ts
index 33dc571..6229753 100644
--- a/src/main.ts
+++ b/src/main.ts
@@ -5,8 +5,9 @@ import App from './App.vue'
 import router from './router'
 import Particles from "@tsparticles/vue3";
 import { loadFull } from "tsparticles";
-import { Quasar, Notify, QExpansionItem } from 'quasar'
+import {Quasar, Notify, QExpansionItem, Dialog, Dark} from 'quasar'
 import '@quasar/extras/material-icons/material-icons.css'
+import '@quasar/extras/bootstrap-icons/bootstrap-icons.css'
 import 'quasar/dist/quasar.css'
 import { createPinia } from 'pinia'
 import axios from 'axios'
@@ -25,10 +26,9 @@ initWebSocket(ui);
 app.use(router)
 app.use(Quasar, {
   plugins: {
-    Notify
-  },
-  components: {
-    QExpansionItem
+    Notify,
+    Dialog,
+    Dark
   }
 })
 app.use(VueAxios, axios)
diff --git a/src/router/index.ts b/src/router/index.ts
index 98e5149..f8edc5d 100644
--- a/src/router/index.ts
+++ b/src/router/index.ts
@@ -1,5 +1,7 @@
 import { createRouter, createWebHistory } from 'vue-router'
 import LoginView from '../views/LoginView.vue'
+import RegisterView from '../views/RegisterView.vue'
+import UsernameSelectionView from '../views/UsernameSelectionView.vue'
 import MainMenuView from '../views/MainMenuView.vue'
 import createGameView from '../views/CreateGame.vue'
 import joinGameView from "@/views/JoinGameView.vue";
@@ -17,13 +19,13 @@ const router = createRouter({
     {
       path: '/',
       component: MainMenuView,
-      meta: { requiresAuth: true },
+      meta: { requiresAuth: false },
       children: [
         {
           path: '',
           name: 'mainmenu',
           component: defaultMenu,
-          meta: { requiresAuth: true }
+          meta: { requiresAuth: false }
         },
         {
           path: 'create',
@@ -41,7 +43,7 @@ const router = createRouter({
           path: 'rules',
           name: 'rules-Game',
           component: rulesView,
-          meta: {requiresAuth: true }
+          meta: {requiresAuth: false }
         },
       ],
     },
@@ -51,6 +53,18 @@ const router = createRouter({
       component: LoginView,
       meta: { requiresAuth: false }
     },
+    {
+      path: '/register',
+      name: 'register',
+      component: RegisterView,
+      meta: { requiresAuth: false }
+    },
+    {
+      path: '/select-username',
+      name: 'select-username',
+      component: UsernameSelectionView,
+      meta: { requiresAuth: false }
+    },
     {
       path: '/game',
       name: 'game',
@@ -69,19 +83,16 @@ const router = createRouter({
 router.beforeEach(async (to, from, next) => {
   const info = useUserInfo();
   const isOnline = navigator.onLine;
+  
   if (to.name === 'offline') {
     if (isOnline) {
-
       try {
         await info.requestState();
-
         if (!info.username) {
           info.clearUserInfo();
           return next('/login');
         }
-
         return next({ name: 'mainmenu' });
-
       } catch (err) {
         info.clearUserInfo();
         return next('/login');
@@ -90,28 +101,27 @@ router.beforeEach(async (to, from, next) => {
       return next();
     }
   }
+  
   if (!isOnline) {
     return next({ name: 'offline' });
   }
 
   if (!to.meta.requiresAuth) return next();
+  
   try {
     await info.requestState();
-
     if (!info.username) {
       info.clearUserInfo();
       return next('/login');
     }
-
     if (info.gameId && to.name !== 'game') {
       return next({ name: 'game' });
     }
-
     next();
   } catch (err) {
-      info.clearUserInfo();
-      next('/login');
-
+    console.error("Routing Error", err);
+    info.clearUserInfo();
+    next('/login');
   }
 });
 
diff --git a/src/views/Game.vue b/src/views/Game.vue
index 663301d..13008cd 100644
--- a/src/views/Game.vue
+++ b/src/views/Game.vue
@@ -25,7 +25,16 @@ ui.requestState().then(() => {
     router.replace("/")
   } else {
     ig.requestGame(ui.gameId).then(() => {
-      wb.connect()
+      // Attempt to connect to WebSocket
+      wb.connect().catch((err) => {
+        console.error('[Game] Initial WebSocket connection failed:', err);
+        $q.notify({
+          message: 'Failed to connect to game server. Please try reconnecting.',
+          color: 'negative',
+          icon: 'error',
+          timeout: 5000
+        });
+      });
     })
   }
 })
diff --git a/src/views/LoginView.vue b/src/views/LoginView.vue
index 50997d6..83da4d5 100644
--- a/src/views/LoginView.vue
+++ b/src/views/LoginView.vue
@@ -1,59 +1,111 @@
 <template>
-  <div class="login-box q-col-gutter-sm">
-    <div class="text-h3 text-center row">
-      <img src="/logo.png" alt="Logo" style="height: 60px; margin-right: 10px;" />
+  <div class="login-container">
+    <div class="login-box">
+      <div class="logo-section">
+        <div class="logo-container">
+          <img src="/logo.png" alt="Logo" class="logo" />
+          <div class="logo-text">KnockOut Whist</div>
+        </div>
+      </div>
+
+      <div class="content-section">
+        <h1 class="title">Welcome Back</h1>
+
+        <q-form @submit.prevent="onSubmit" class="form-section">
+          <q-input
+            v-model="username"
+            label="Username"
+            filled
+            color="primary"
+            label-color="grey-6"
+            :error="!!loginError"
+            :error-message="loginError"
+            class="form-input"
+            lazy-rules
+            :rules="[ val => val && val.length > 0 || 'Username is required']"
+          >
+            <template v-slot:prepend>
+              <q-icon name="person" color="grey-6" />
+            </template>
+          </q-input>
+
+          <q-input
+            v-model="password"
+            label="Password"
+            filled
+            type="password"
+            color="primary"
+            label-color="grey-6"
+            :error="!!loginError"
+            :error-message="loginError"
+            class="form-input"
+            lazy-rules
+            :rules="[
+              val => !!val || 'Password is required'
+            ]"
+          >
+            <template v-slot:prepend>
+              <q-icon name="lock" color="grey-6" />
+            </template>
+          </q-input>
+
+          <div class="action-buttons">
+            <q-btn
+              type="submit"
+              label="Sign In"
+              color="primary"
+              class="submit-btn"
+              :loading="inProgress"
+              size="md"
+              rounded
+            />
+          </div>
+        </q-form>
+
+        <div class="divider-section">
+          <div class="divider">
+            <span class="divider-text">Or continue with</span>
+          </div>
+        </div>
+
+        <div class="social-buttons">
+          <q-btn
+            @click="loginWithProvider('discord')"
+            class="social-btn discord-btn"
+            size="md"
+            rounded
+            icon="discord"
+            label="Discord"
+            />
+          <q-btn
+            @click="loginWithProvider('keycloak')"
+            class="social-btn keycloak-btn"
+            size="md"
+            rounded
+            icon="emoji_people"
+            label="Keycloak"
+            />
+        </div>
+
+        <div class="register-link">
+          <span class="register-text">Don't have an account?</span>
+          <q-btn
+            flat
+            color="primary"
+            label="Register"
+            @click="goToRegister"
+            class="register-btn"
+            size="md"
+            dense
+          />
+        </div>
+      </div>
     </div>
-    <q-form @submit.prevent="onSubmit"
-            class="q-gutter-md row justify-center"
-            style="width: 100%">
-
-      <div class="row q-col-gutter-sm" style="width: 100%">
-        <q-input
-          style="width: 100%"
-          filled
-          dark
-          label-color="white"
-          color="white"
-          v-model="username"
-          label="Username *"
-
-          :error="!!loginError"
-          :error-message="loginError"
-
-          lazy-rules
-          :rules="[ val => val && val.length > 0 || 'Username is required']"
-        />
-      </div>
-
-      <div class="row q-col-gutter-sm" style="width: 100%">
-        <q-input
-          style="width: 100%"
-          filled
-          dark
-          type="password"
-          label-color="white"
-          color="white"
-          v-model="password"
-          label="Password *"
-          :error="!!loginError"
-          :error-message="loginError"
-
-          lazy-rules
-          :rules="[
-            val => !!val || 'Password is required'
-          ]"
-        />
-      </div>
-
-      <div class="row justify-center">
-        <q-btn type="submit" label="Login" push color="dark" />
-      </div>
-    </q-form>
+    <vue-particles
+      id="particles-js"
+      :options='options'
+    />
   </div>
-  <vue-particles
-    id="particles-js"
-    :options='options'
-  />
 </template>
 
 <script lang="ts" setup>
@@ -88,6 +140,14 @@ const onSubmit = () => {
   )
 }
 
+const loginWithProvider = (provider: string) => {
+  window.location.href = `${api}/auth/${provider}`
+}
+
+const goToRegister = () => {
+  router.push('/register')
+}
+
 const options = {
   "particles": {
     "number": {
@@ -200,19 +260,213 @@ const options = {
 </script>
 
 <style scoped>
-.login-box {
-  position: fixed;
+.login-container {
+  position: relative;
+  display: flex;
   align-items: center;
   justify-content: center;
-  top: 50%;
-  left: 50%;
-  transform: translate(-50%, -50%);
-  display: flex;
+  overflow: hidden;
+  padding: 2rem;
+  box-sizing: border-box;
+}
+
+.login-box {
   width: 100%;
   max-width: 420px;
-  padding: 1rem;
+  height: 100%;
+  max-height: calc(100vh - 1rem);
+  background: var(--color-background-soft);
+  backdrop-filter: blur(20px);
+  border-radius: 24px;
+  overflow-y: auto;
+  overflow-x: hidden;
   z-index: 2;
-  background-color: var(--color-background);
-  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.1);
+  border: 1px solid var(--color-border);
+  box-sizing: border-box;
+  box-shadow: 0 10px 10px rgba(0, 0, 0, 0.5);
+}
+
+.logo-section {
+  background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+  padding: 2rem;
+  text-align: center;
+  border-bottom: 1px solid var(--color-border);
+}
+
+.logo-container {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 1rem;
+}
+
+.logo {
+  height: 50px;
+  width: auto;
+  filter: brightness(0) invert(1);
+}
+
+.logo-text {
+  color: #ffffff;
+  font-size: 1.5rem;
+  font-weight: 700;
+  letter-spacing: 0.5px;
+}
+
+.content-section {
+  padding: 1.5rem;
+}
+
+.title {
+  color: var(--color-heading);
+  font-size: 1.8rem;
+  font-weight: 700;
+  text-align: center;
+  margin-bottom: 0.5rem;
+}
+
+.subtitle {
+  color: var(--color-text);
+  text-align: center;
+  margin-bottom: 2rem;
+  font-size: 0.95rem;
+  line-height: 1.5;
+  opacity: 0.8;
+}
+
+.form-section {
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem;
+  margin-bottom: 2rem;
+}
+
+.form-input {
+  border-radius: 12px;
+}
+
+.action-buttons {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  margin-top: 1rem;
+}
+
+.submit-btn {
+  width: 100%;
+  height: 48px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  border: none;
+}
+
+.divider-section {
+  margin: 2rem 0;
+}
+
+.divider {
+  position: relative;
+  text-align: center;
+}
+
+.divider::before {
+  content: '';
+  position: absolute;
+  top: 50%;
+  left: 0;
+  right: 0;
+  height: 1px;
+  background: var(--color-border);
+}
+
+.divider-text {
+  background: var(--color-background-soft);
+  padding: 0 1rem;
+  color: var(--color-text);
+  font-size: 0.85rem;
+  position: relative;
+  opacity: 0.7;
+}
+
+.social-buttons {
+  display: flex;
+  gap: 1rem;
+  margin-bottom: 2rem;
+}
+
+.social-btn {
+  flex: 1;
+  height: 48px;
+  background: var(--color-background-mute);
+  border: 2px solid var(--color-border);
+  color: var(--color-heading);
+  font-weight: 500;
+  transition: all 0.3s ease;
+}
+
+.social-btn:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
+}
+
+.discord-btn:hover {
+  border-color: #5865F2;
+  background: rgba(88, 101, 242, 0.1);
+}
+
+.keycloak-btn:hover {
+  border-color: #0088CC;
+  background: rgba(0, 136, 204, 0.1);
+}
+
+
+.register-link {
+  text-align: center;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+}
+
+.register-text {
+  color: var(--color-text);
+  font-size: 0.9rem;
+  opacity: 0.7;
+}
+
+.register-btn {
+  font-weight: 600;
+  text-transform: none;
+}
+
+#particles-js {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  z-index: 1;
+}
+
+@media (max-width: 600px) {
+  .login-box {
+    max-width: 100%;
+    border-radius: 16px;
+    max-height: calc(100vh - 1rem);
+  }
+
+  .content-section {
+    padding: 1rem;
+  }
+
+  .title {
+    font-size: 1.5rem;
+  }
+
+  .social-buttons {
+    flex-direction: column;
+  }
 }
 </style>
diff --git a/src/views/RegisterView.vue b/src/views/RegisterView.vue
new file mode 100644
index 0000000..171aa4e
--- /dev/null
+++ b/src/views/RegisterView.vue
@@ -0,0 +1,516 @@
+<template>
+  <div class="register-container">
+    <div class="register-box">
+      <div class="logo-section">
+        <div class="logo-container">
+          <img src="/logo.png" alt="Logo" class="logo" />
+          <div class="logo-text">KnockOut Whist</div>
+        </div>
+      </div>
+
+      <div class="content-section">
+        <h1 class="title">Create Account</h1>
+        <p class="subtitle">Join the ultimate card game experience</p>
+
+        <q-form @submit.prevent="onSubmit" class="form-section">
+          <q-input
+            v-model="username"
+            label="Username"
+            filled
+            color="primary"
+            label-color="grey-6"
+            :error="!!errorMessage"
+            :error-message="errorMessage"
+            class="form-input"
+            lazy-rules
+            :rules="[
+              val => !!val && val.trim().length > 0 || 'Username is required',
+              val => val && val.trim().length >= 3 || 'Username must be at least 3 characters',
+              val => val && val.trim().length <= 30 || 'Username must be less than 30 characters',
+              val => /^[a-zA-Z0-9_-]+$/.test(val) || 'Username can only contain letters, numbers, underscores, and hyphens'
+            ]"
+          >
+            <template v-slot:prepend>
+              <q-icon name="person" color="grey-6" />
+            </template>
+          </q-input>
+
+          <q-input
+            v-model="password"
+            label="Password"
+            filled
+            type="password"
+            color="primary"
+            label-color="grey-6"
+            :error="!!errorMessage"
+            :error-message="errorMessage"
+            class="form-input"
+            lazy-rules
+            :rules="[
+              val => !!val || 'Password is required',
+              val => val && val.length >= 6 || 'Password must be at least 6 characters'
+            ]"
+          >
+            <template v-slot:prepend>
+              <q-icon name="lock" color="grey-6" />
+            </template>
+          </q-input>
+
+          <q-input
+            v-model="confirmPassword"
+            label="Confirm Password"
+            filled
+            type="password"
+            color="primary"
+            label-color="grey-6"
+            :error="!!errorMessage"
+            :error-message="errorMessage"
+            class="form-input"
+            lazy-rules
+            :rules="[
+              val => !!val || 'Password confirmation is required',
+              val => val === password || 'Passwords do not match'
+            ]"
+          >
+            <template v-slot:prepend>
+              <q-icon name="lock_outline" color="grey-6" />
+            </template>
+          </q-input>
+
+          <div class="action-buttons">
+            <q-btn
+              type="submit"
+              label="Create Account"
+              color="primary"
+              class="submit-btn"
+              :loading="inProgress"
+              size="md"
+              rounded
+            />
+          </div>
+        </q-form>
+
+        <div class="divider-section">
+          <div class="divider">
+            <span class="divider-text">Or register with</span>
+          </div>
+        </div>
+
+        <div class="social-buttons">
+          <q-btn
+            @click="loginWithProvider('discord')"
+            class="social-btn discord-btn"
+            size="md"
+            rounded
+            icon="discord"
+            label="Discord"
+          />
+          <q-btn
+            @click="loginWithProvider('keycloak')"
+            class="social-btn keycloak-btn"
+            size="md"
+            rounded
+            icon="emoji_people"
+            label="Keycloak"
+          />
+        </div>
+
+        <div class="login-link">
+          <span class="login-text">Already have an account?</span>
+          <q-btn
+            flat
+            color="primary"
+            label="Login"
+            @click="goToLogin"
+            class="login-btn"
+            size="md"
+            dense
+          />
+        </div>
+      </div>
+    </div>
+    <vue-particles
+      id="particles-js"
+      :options='options'
+    />
+  </div>
+</template>
+
+<script lang="ts" setup>
+import { useQuasar } from 'quasar'
+import { ref } from 'vue'
+import axios from "axios"
+import router from "@/router"
+
+const api = window?.__RUNTIME_CONFIG__?.API_URL
+const $q = useQuasar()
+
+const username = ref('')
+const password = ref('')
+const confirmPassword = ref('')
+const inProgress = ref(false)
+const errorMessage = ref('')
+
+const onSubmit = async () => {
+  if (inProgress.value) return
+
+  inProgress.value = true
+  errorMessage.value = ''
+
+  try {
+    const response = await axios.post(`${api}/register`, {
+      username: username.value.trim(),
+      password: password.value
+    })
+
+    if (response.status === 201) {
+      $q.notify({
+        type: 'positive',
+        message: 'Registration successful! Please login.',
+        position: 'top'
+      })
+      router.push('/login')
+    }
+  } catch (error: any) {
+    if (error.response?.status === 409) {
+      errorMessage.value = 'Username already taken'
+    } else if (error.response?.status === 400) {
+      errorMessage.value = error.response.data?.message || 'Invalid input'
+    } else {
+      errorMessage.value = 'Registration failed. Please try again.'
+    }
+  } finally {
+    inProgress.value = false
+  }
+}
+
+const goToLogin = () => {
+  router.push('/login')
+}
+
+const loginWithProvider = (provider: string) => {
+  window.location.href = `${api}/auth/${provider}`
+}
+
+const options = {
+  "particles": {
+    "number": {
+      "value": 80,
+      "density": {
+        "enable": true,
+        "area": 800
+      }
+    },
+    "color": {
+      "value": "#ffffff"
+    },
+    "shape": {
+      "type": "circle",
+      "stroke": {
+        "width": 0,
+        "color": "#000000"
+      },
+      "polygon": {
+        "sides": 5
+      }
+    },
+    "opacity": {
+      "value": 0.5,
+      "random": false,
+      "animation": {
+        "enable": false,
+        "speed": 1,
+        "minimumValue": 0.1,
+        "sync": false
+      }
+    },
+    "size": {
+      "value": 3,
+      "random": true,
+      "animation": {
+        "enable": false,
+        "speed": 40,
+        "minimumValue": 0.1,
+        "sync": false
+      }
+    },
+    "links": {
+      "enable": true,
+      "distance": 150,
+      "color": "#ffffff",
+      "opacity": 0.4,
+      "width": 1
+    },
+    "move": {
+      "enable": true,
+      "speed": 1,
+      "direction": "none",
+      "random": false,
+      "straight": false,
+      "outModes": {
+        "default": "out"
+      },
+      "attract": {
+        "enable": false,
+        "rotate": {
+          "x": 600,
+          "y": 1200
+        }
+      }
+    }
+  },
+  "interactivity": {
+    "detectsOn": "canvas",
+    "events": {
+      "onHover": {
+        "enable": false,
+        "mode": "repulse"
+      },
+      "onClick": {
+        "enable": false,
+        "mode": "push"
+      },
+      "resize": true
+    },
+    "modes": {
+      "grab": {
+        "distance": 400,
+        "links": {
+          "opacity": 1
+        }
+      },
+      "bubble": {
+        "distance": 400,
+        "size": 40,
+        "duration": 2,
+        "opacity": 8,
+        "speed": 3
+      },
+      "repulse": {
+        "distance": 200,
+        "duration": 0.4
+      },
+      "push": {
+        "quantity": 4
+      },
+      "remove": {
+        "quantity": 2
+      }
+    }
+  },
+  "detectRetina": true
+}
+</script>
+
+<style scoped>
+.register-container {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  overflow: hidden;
+  padding: 1rem;
+  box-sizing: border-box;
+}
+
+.register-box {
+  width: 100%;
+  max-width: 420px;
+  max-height: calc(100vh - 1rem);
+  background: var(--color-background-soft);
+  backdrop-filter: blur(20px);
+  border-radius: 24px;
+  box-shadow: 0 2px 2px rgba(0, 0, 0, 0.5);
+  overflow-y: auto;
+  overflow-x: hidden;
+  z-index: 2;
+  border: 1px solid var(--color-border);
+  box-sizing: border-box;
+}
+
+.logo-section {
+  background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+  padding: 2rem;
+  text-align: center;
+  border-bottom: 1px solid var(--color-border);
+}
+
+.logo-container {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 1rem;
+}
+
+.logo {
+  height: 50px;
+  width: auto;
+  filter: brightness(0) invert(1);
+}
+
+.logo-text {
+  color: #ffffff;
+  font-size: 1.5rem;
+  font-weight: 700;
+  letter-spacing: 0.5px;
+}
+
+.content-section {
+  padding: 1.5rem;
+}
+
+.title {
+  color: var(--color-heading);
+  font-size: 1.8rem;
+  font-weight: 700;
+  text-align: center;
+  margin-bottom: 0.5rem;
+}
+
+.subtitle {
+  color: var(--color-text);
+  text-align: center;
+  margin-bottom: 2rem;
+  font-size: 0.95rem;
+  line-height: 1.5;
+  opacity: 0.8;
+}
+
+.form-section {
+  display: flex;
+  flex-direction: column;
+  margin-bottom: 2rem;
+}
+
+.form-input {
+  border-radius: 12px;
+}
+
+.action-buttons {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  margin-top: 1rem;
+}
+
+.submit-btn {
+  width: 100%;
+  height: 48px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  border: none;
+  color: white;
+}
+
+.divider-section {
+  margin: 2rem 0;
+}
+
+.divider {
+  position: relative;
+  text-align: center;
+}
+
+.divider::before {
+  content: '';
+  position: absolute;
+  top: 50%;
+  left: 0;
+  right: 0;
+  height: 1px;
+  background: var(--color-border);
+}
+
+.divider-text {
+  background: var(--color-background-soft);
+  padding: 0 1rem;
+  color: var(--color-text);
+  font-size: 0.85rem;
+  position: relative;
+  opacity: 0.7;
+}
+
+.social-buttons {
+  display: flex;
+  gap: 1rem;
+  margin-bottom: 2rem;
+}
+
+.social-btn {
+  flex: 1;
+  height: 48px;
+  background: var(--color-background-mute);
+  border: 2px solid var(--color-border);
+  color: var(--color-heading);
+  font-weight: 500;
+  transition: all 0.3s ease;
+}
+
+.social-btn:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
+}
+
+.discord-btn:hover {
+  border-color: #5865F2;
+  background: rgba(88, 101, 242, 0.1);
+}
+
+.keycloak-btn:hover {
+  border-color: #0088CC;
+  background: rgba(0, 136, 204, 0.1);
+}
+
+.social-icon {
+  margin-right: 0.5rem;
+}
+
+.social-text {
+  font-weight: 500;
+}
+
+.login-link {
+  text-align: center;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+}
+
+.login-text {
+  color: var(--color-text);
+  font-size: 0.9rem;
+  opacity: 0.7;
+}
+
+#particles-js {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  z-index: 1;
+}
+
+@media (max-width: 600px) {
+  .register-box {
+    max-width: 100%;
+    border-radius: 16px;
+    max-height: calc(100vh - 1rem);
+  }
+
+  .content-section {
+    padding: 1rem;
+  }
+
+  .title {
+    font-size: 1.5rem;
+  }
+
+  .social-buttons {
+    flex-direction: column;
+  }
+}
+</style>
diff --git a/src/views/UsernameSelectionView.vue b/src/views/UsernameSelectionView.vue
new file mode 100644
index 0000000..3e2c2e8
--- /dev/null
+++ b/src/views/UsernameSelectionView.vue
@@ -0,0 +1,457 @@
+<template>
+  <div class="username-selection-container">
+    <div class="username-selection-box">
+      <div class="logo-section">
+        <div class="logo-container">
+          <img src="/logo.png" alt="Logo" class="logo" />
+          <div class="logo-text">KnockOut Whist</div>
+        </div>
+      </div>
+
+      <div class="content-section">
+        <h1 class="title">Choose Your Username</h1>
+        <p class="subtitle">
+          You're signed in with <span class="provider-badge">{{ userInfo.providerName }}</span>. Please choose a username for your account.
+        </p>
+
+        <div class="user-info-card">
+          <div class="user-avatar">
+            <img v-if="userInfo.picture" :src="userInfo.picture" alt="Profile" class="avatar-img" />
+            <div v-else class="avatar-text">{{ userInfo.name?.charAt(0)?.toUpperCase() || 'U' }}</div>
+          </div>
+          <div class="user-details">
+            <div class="user-name">{{ userInfo.name || 'Unknown User' }}</div>
+            <div class="user-provider">Signed in with {{ userInfo.providerName }}</div>
+          </div>
+        </div>
+
+        <q-form @submit.prevent="onSubmit" class="form-section">
+          <q-input
+            v-model="username"
+            label="Username"
+            filled
+            dark
+            color="primary"
+            label-color="grey-6"
+            :error="!!errorMessage"
+            :error-message="errorMessage"
+            :loading="inProgress"
+            class="username-input"
+            lazy-rules
+            :rules="[
+              val => !!val && val.trim().length > 0 || 'Username is required',
+              val => val && val.trim().length >= 3 || 'Username must be at least 3 characters',
+              val => val && val.trim().length <= 30 || 'Username must be less than 30 characters',
+              val => /^[a-zA-Z0-9_-]+$/.test(val) || 'Username can only contain letters, numbers, underscores, and hyphens'
+            ]"
+          >
+            <template v-slot:prepend>
+              <q-icon name="person" color="grey-6" />
+            </template>
+          </q-input>
+
+          <div class="action-buttons">
+            <q-btn
+              type="submit"
+              label="Complete Registration"
+              color="primary"
+              class="submit-btn"
+              :loading="inProgress"
+              size="md"
+              rounded
+            />
+            <q-btn
+              flat
+              color="grey-6"
+              label="Cancel"
+              @click="goToLogin"
+              class="cancel-btn"
+              size="md"
+            />
+          </div>
+        </q-form>
+      </div>
+    </div>
+    <vue-particles
+      id="particles-js"
+      :options='options'
+    />
+  </div>
+</template>
+
+<script lang="ts" setup>
+import { useQuasar } from 'quasar'
+import { ref, onMounted } from 'vue'
+import axios from "axios"
+import router from "@/router"
+import { useUserInfo } from "@/composables/useUserInfo"
+
+const api = window?.__RUNTIME_CONFIG__?.API_URL
+const $q = useQuasar()
+const uInfo = useUserInfo()
+
+const username = ref('')
+const inProgress = ref(false)
+const errorMessage = ref('')
+const userInfo = ref({
+  id: '',
+  email: '',
+  name: '',
+  picture: '',
+  provider: '',
+  providerName: ''
+})
+
+onMounted(async () => {
+  // Get user info from session storage or API
+  try {
+    const response = await axios.get(`${api}/select-username`, { withCredentials: true })
+    userInfo.value = response.data
+  } catch (error) {
+    console.error('Failed to get user info:', error)
+    router.push('/login')
+  }
+})
+
+const onSubmit = async () => {
+  if (inProgress.value) return
+
+  inProgress.value = true
+  errorMessage.value = ''
+
+  try {
+    const response = await axios.post(`${api}/submit-username`, {
+      username: username.value.trim()
+    }, { withCredentials: true })
+
+    if (response.status === 200) {
+      // User successfully created and logged in
+      await uInfo.requestState()
+      router.push('/')
+    }
+  } catch (error: any) {
+    if (error.response?.status === 409) {
+      errorMessage.value = 'Username already taken'
+    } else if (error.response?.status === 400) {
+      errorMessage.value = error.response.data?.message || 'Invalid username'
+    } else {
+      errorMessage.value = 'Registration failed. Please try again.'
+    }
+  } finally {
+    inProgress.value = false
+  }
+}
+
+const goToLogin = () => {
+  router.push('/login')
+}
+
+const options = {
+  "particles": {
+    "number": {
+      "value": 80,
+      "density": {
+        "enable": true,
+        "area": 800
+      }
+    },
+    "color": {
+      "value": "#ffffff"
+    },
+    "shape": {
+      "type": "circle",
+      "stroke": {
+        "width": 0,
+        "color": "#000000"
+      },
+      "polygon": {
+        "sides": 5
+      }
+    },
+    "opacity": {
+      "value": 0.5,
+      "random": false,
+      "animation": {
+        "enable": false,
+        "speed": 1,
+        "minimumValue": 0.1,
+        "sync": false
+      }
+    },
+    "size": {
+      "value": 3,
+      "random": true,
+      "animation": {
+        "enable": false,
+        "speed": 40,
+        "minimumValue": 0.1,
+        "sync": false
+      }
+    },
+    "links": {
+      "enable": true,
+      "distance": 150,
+      "color": "#ffffff",
+      "opacity": 0.4,
+      "width": 1
+    },
+    "move": {
+      "enable": true,
+      "speed": 1,
+      "direction": "none",
+      "random": false,
+      "straight": false,
+      "outModes": {
+        "default": "out"
+      },
+      "attract": {
+        "enable": false,
+        "rotate": {
+          "x": 600,
+          "y": 1200
+        }
+      }
+    }
+  },
+  "interactivity": {
+    "detectsOn": "canvas",
+    "events": {
+      "onHover": {
+        "enable": false,
+        "mode": "repulse"
+      },
+      "onClick": {
+        "enable": false,
+        "mode": "push"
+      },
+      "resize": true
+    },
+    "modes": {
+      "grab": {
+        "distance": 400,
+        "links": {
+          "opacity": 1
+        }
+      },
+      "bubble": {
+        "distance": 400,
+        "size": 40,
+        "duration": 2,
+        "opacity": 8,
+        "speed": 3
+      },
+      "repulse": {
+        "distance": 200,
+        "duration": 0.4
+      },
+      "push": {
+        "quantity": 4
+      },
+      "remove": {
+        "quantity": 2
+      }
+    }
+  },
+  "detectRetina": true
+}
+</script>
+
+<style scoped>
+.username-selection-container {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  overflow: hidden;
+  padding: 3rem;
+  box-sizing: border-box;
+}
+
+.username-selection-box {
+  width: 100%;
+  max-width: 420px;
+  height: 100%;
+  max-height: calc(100vh - 1rem);
+  background: var(--color-background-soft);
+  backdrop-filter: blur(20px);
+  border-radius: 24px;
+  box-shadow: 0 10px 10px rgba(0, 0, 0, 0.5);
+  overflow-y: auto;
+  overflow-x: hidden;
+  z-index: 2;
+  border: 1px solid var(--color-border);
+  box-sizing: border-box;
+}
+
+.logo-section {
+  background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+  padding: 2rem;
+  text-align: center;
+  border-bottom: 1px solid var(--color-border);
+}
+
+.logo-container {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 1rem;
+}
+
+.logo {
+  height: 50px;
+  width: auto;
+  filter: brightness(0) invert(1);
+}
+
+.logo-text {
+  color: #ffffff;
+  font-size: 1.5rem;
+  font-weight: 700;
+  letter-spacing: 0.5px;
+}
+
+.content-section {
+  padding: 1.5rem;
+}
+
+.title {
+  color: var(--color-heading);
+  font-size: 1.8rem;
+  font-weight: 700;
+  text-align: center;
+  margin-bottom: 0.5rem;
+}
+
+.subtitle {
+  color: var(--color-text);
+  text-align: center;
+  margin-bottom: 2rem;
+  font-size: 0.95rem;
+  line-height: 1.5;
+  opacity: 0.8;
+}
+
+.provider-badge {
+  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  padding: 0.2rem 0.6rem;
+  border-radius: 12px;
+  font-size: 0.85rem;
+  font-weight: 600;
+}
+
+.user-info-card {
+  background: var(--color-background-mute);
+  border-radius: 16px;
+  padding: 1.5rem;
+  margin-bottom: 2rem;
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  border: 1px solid var(--color-border);
+}
+
+.user-avatar {
+  width: 60px;
+  height: 60px;
+  border-radius: 50%;
+  overflow: hidden;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  flex-shrink: 0;
+}
+
+.avatar-img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.avatar-text {
+  color: white;
+  font-weight: 700;
+  font-size: 1.4rem;
+}
+
+.user-details {
+  flex: 1;
+}
+
+.user-name {
+  color: var(--color-heading);
+  font-weight: 600;
+  font-size: 1.1rem;
+  margin-bottom: 0.25rem;
+}
+
+.user-provider {
+  color: var(--color-text);
+  font-size: 0.9rem;
+  opacity: 0.7;
+}
+
+.form-section {
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem;
+}
+
+.username-input {
+  border-radius: 12px;
+}
+
+.action-buttons {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  margin-top: 1rem;
+}
+
+.submit-btn {
+  width: 100%;
+  height: 48px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  border: none;
+}
+
+.cancel-btn {
+  width: 100%;
+  height: 48px;
+  font-weight: 500;
+  color: var(--color-text);
+  opacity: 0.7;
+}
+
+.cancel-btn:hover {
+  opacity: 1;
+}
+
+#particles-js {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  z-index: 1;
+}
+
+@media (max-width: 600px) {
+  .username-selection-box {
+    max-width: 100%;
+    border-radius: 16px;
+    max-height: calc(100vh - 1rem);
+  }
+
+  .content-section {
+    padding: 1rem;
+  }
+
+  .title {
+    font-size: 1.5rem;
+  }
+}
+</style>