devforth · SerVitasik · Jun 18, 2026 · Jun 18, 2026 · Jun 18, 2026 · Jun 18, 2026
diff --git a/README.md b/README.md
@@ -12,13 +12,29 @@ Enables OAuth2-based authentication for an adminforth application.
 - Support external identity providers for sign-in.
 - Reduce friction in authentication workflows.
 - Integrate provider-based auth into the admin panel.
+- Start OAuth flow directly from an external page via `?start_oauth=<provider>` query parameter.
 
 ## Documentation
 
 Full setup and configuration guide:
 
 [AdminForth OAuth Documentation](https://adminforth.dev/docs/tutorial/Plugins/oauth/)
 
+## Starting OAuth flow from an external page
+
+If you have an external website with a "Sign in with Google" button that should open the AdminForth OAuth flow directly — without showing the login form first — use the `start_oauth` query parameter:
+
+```
+https://your-admin.example.com/login?start_oauth=google
+https://your-admin.example.com/login?start_oauth=clerk
+```
+
+The value must match the provider name (case-insensitive). AdminForth will immediately redirect the user to the OAuth provider, skipping the login page entirely.
+
+**Supported values** depend on the providers configured in your plugin setup. The name is derived from the adapter class name — for example `AdminForthAdapterOauth2Google` → `google`, `AdminForthAdapterOauth2Clerk` → `clerk`.
+
+If the specified provider is not found, an error message is shown on the login page. If `start_oauth` is provided without a value (`?start_oauth`), nothing happens and the regular login form is displayed.
+
 ## About AdminForth
 
 AdminForth is an open-source, agent-first admin framework for building robust admin panels and back-office applications faster.

diff --git a/custom/OAuthLoginButtons.vue b/custom/OAuthLoginButtons.vue
@@ -17,13 +17,22 @@
 </template>
 
 <script setup>
+import { onMounted } from 'vue';
+import { useRoute } from 'vue-router';
+import { useAdminforth } from '@/adminforth';
+import { useI18n } from 'vue-i18n';
+
 const props = defineProps({
   meta: {
     type: Object,
     required: true
   }
 });
 
+const route = useRoute();
+const { alert } = useAdminforth();
+const { t } = useI18n();
+
 const getProviderName = (provider) => {
   return provider.replace('AdminForthAdapter', '').replace('Oauth2', '');
 };
@@ -40,4 +49,24 @@ const handleLogin = (authUrl) => {
   url.searchParams.set('redirect_uri', redirectUri);
   return url.toString();
 };
+
+function tryStartOAuth(query) {
+  if (!('start_oauth' in query)) return;
+
+  const provider = props.meta.providers.find(({ provider }) =>
+    getProviderName(provider).toLowerCase() === query.start_oauth.toLowerCase()
+  );
+
+  if (provider) {
+    window.location.href = handleLogin(provider.authUrl);
+  } else if (query.start_oauth === '') {
+    alert({ variant: 'warning', message: t('Empty OAuth provider') });
+  } else {
+    alert({ variant: 'warning', message: t('Unknown OAuth provider: {provider}', { provider: query.start_oauth }) });
+  }
+}
+
+onMounted(() => {
+  tryStartOAuth(route.query);
+});
 </script>