@geenius/auth

Authentication contracts, provider adapters, UI bindings, and Convex support for the Geenius ecosystem.

@geenius/auth publishes a shared auth contract plus React, React CSS, SolidJS, SolidJS CSS, and Convex subpaths so apps can adopt a consistent authentication surface without relying on unpublished internals.

Install

pnpm add @geenius/auth

Import Paths

Use the root package for the framework-agnostic contract, then opt into the subpath that matches your UI or backend runtime.

import { configureAuth } from '@geenius/auth'
import { createAuthProvider } from '@geenius/auth/shared'
import { AuthProvider, SignInPage } from '@geenius/auth/react'
import { SignInPage as ReactCssSignInPage } from '@geenius/auth/react-css'
import '@geenius/auth/react-css/styles.css'
import { createAuth, SignInPage as SolidSignInPage } from '@geenius/auth/solidjs'
import { SignInPage as SolidCssSignInPage } from '@geenius/auth/solidjs-css'
import '@geenius/auth/solidjs-css/styles.css'
import { authTables } from '@geenius/auth/convex'

| Import path | Purpose | | --- | --- | | @geenius/auth | Root shared contract and configuration helpers | | @geenius/auth/shared | Framework-agnostic providers, schemas, and auth utilities | | @geenius/auth/react | React hooks, providers, and Tailwind-styled components/pages | | @geenius/auth/react-css | React hooks, providers, and vanilla CSS components/pages | | @geenius/auth/react-css/styles.css | Stylesheet for the React CSS variant | | @geenius/auth/solidjs | SolidJS primitives, providers, and Tailwind-styled components/pages | | @geenius/auth/solidjs-css | SolidJS primitives, providers, and vanilla CSS components/pages | | @geenius/auth/solidjs-css/styles.css | Stylesheet for the SolidJS CSS variant | | @geenius/auth/convex | Auth schema tables and Convex server helpers |

Usage

import { configureAuth } from '@geenius/auth'
import { AuthProvider, SignInPage } from '@geenius/auth/react'

configureAuth({
  provider: 'better-auth',
  baseUrl: '/api/auth',
})

export function AuthScreen() {
  return (
    <AuthProvider config={{ provider: 'better-auth', baseUrl: '/api/auth' }}>
      <SignInPage branding={{ name: 'Geenius Cloud' }} />
    </AuthProvider>
  )
}

import '@geenius/auth/react-css/styles.css'
import { SignInPage } from '@geenius/auth/react-css'

export function MarketingSignIn() {
  return <SignInPage branding={{ name: 'Geenius Cloud', tagline: 'Sign in to continue.' }} />
}

import { createAuth, SignInPage } from '@geenius/auth/solidjs'

const auth = createAuth()

export function SolidAuthRoute() {
  return <SignInPage auth={auth} branding={{ name: 'Geenius Cloud' }} />
}

import { authTables } from '@geenius/auth/convex'

export const schema = authTables

Review Apps

The repository includes React and SolidJS review apps for side-by-side validation of the Tailwind and vanilla CSS variants. They are used to verify visual parity, auth flows, and regression coverage across the exported UI surfaces.

Package Contract

• Root imports expose the shared, framework-agnostic auth contract.
• React and SolidJS consumers use stable subpath exports for Tailwind and vanilla CSS variants.
• Review apps stay out of the publish surface.
• Versioning and release are handled through Changesets and GitHub Actions.

License

FSL-1.1-Apache-2.0. Commercial use is governed by the terms in LICENSE.