chore(examples): add Astro integration app

[halvaradop]

Description

This pull request introduces a new Astro integration example for Aura Auth. The example demonstrates an integration using Astro + React, covering both client-side and server-side rendering authentication flows.

The implementation is based on the existing Next.js App Router example and has been adapted to support Astro’s architecture and conventions.

Note

This integration example highlights the core purpose of the integration examples: to identify unexpected behaviors, unsupported values, and framework-specific limitations when using the @aura-stack/auth package across different libraries and frameworks.

In the Astro example, an issue was identified with environment variable resolution. Aura Auth currently reads environment variables via Node.js using process.env, while Astro (similar to Vite) exposes environment variables through import.meta.env.

Due to this incompatibility, the integration example cannot be fully completed at the moment, and this PR is marked as a draft.

Relevant code reference:

auth/packages/core/src/oauth/index.ts

Lines 55 to 68 in 8fadacd

	const defineOAuthEnvironment = (oauth: string) => {
	const env = process.env
	const clientIdSuffix = `${oauth.toUpperCase()}_CLIENT_ID`
	const clientSecretSuffix = `${oauth.toUpperCase()}_CLIENT_SECRET`
	const loadEnvs = OAuthEnvSchema.safeParse({
	clientId: env[`AURA_AUTH_${clientIdSuffix}`] ?? env[`AUTH_${clientIdSuffix}`] ?? env[`${clientIdSuffix}`],
	clientSecret: env[`AURA_AUTH_${clientSecretSuffix}`] ?? env[`AUTH_${clientSecretSuffix}`] ?? env[`${clientSecretSuffix}`],
	})
	if (!loadEnvs.success) {
	const msg = JSON.stringify(formatZodError(loadEnvs.error), null, 2)
	throw new AuthInternalError("INVALID_ENVIRONMENT_CONFIGURATION", msg)
	}
	return loadEnvs.data
	}

A future enhancement is planned to add multi-environment variable support, allowing Aura Auth to read from different environment sources depending on the runtime.

Resources

• Using environment variables in Astro
• Vite Env Variables and Modes

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

2 Skipped Deployments

Project	Deployment	Review	Updated (UTC)
auth	Skipped		Jan 29, 2026 3:06am
auth-nextjs-demo	Skipped		Jan 29, 2026 3:06am