Examples

Basic Authentication

Minimal setup with Core module and stateless JWT (default):

store, _ := storage.NewGormStorage(storage.GormConfig{
    Dialect: types.DialectTypeSqlite,
    DSN:     "auth.db",
})

a, _ := auth.New(&config.Config{
    Storage:     store,
    AutoMigrate: true,
    Security: types.SecurityConfig{
        JwtSecretKey:  "your-secret-key-min-32-chars!!",
        EncryptionKey: "your-encryption-key-32-chars!!",
    },
})

a.Initialize(context.Background())

mux := http.NewServeMux()
stdhttp.Register(mux, a)
http.ListenAndServe(":8080", mux)

---

Session-Based Auth

Server-side sessions with cookie strategy:

a.Use(session.New(&config.SessionModuleConfig{
    EnableSessionManagement: true,
    Strategy:                types.SessionStrategyCookieCache,
    CookieCacheTTL:          5 * time.Minute,
    SlidingExpiration:       true,
}, nil))

---

With Notifications

Add email notifications for signup, password reset, and login alerts:

a.Use(notification.New(&notification.Config{
    EmailSender: senders.NewSendGridEmailSender(&senders.SendGridConfig{
        APIKey:      "SG.xxxxx",
        DefaultFrom: "noreply@yourapp.com",
    }),
    EnableWelcomeEmail:       true,
    EnablePasswordResetEmail: true,
    EnableLoginAlerts:        true,
}))

---

With Two-Factor Auth

TOTP-based 2FA with backup codes:

a.Use(twofactor.New(&twofactor.TwoFactorConfig{
    Issuer:           "MyApp",
    BackupCodesCount: 10,
    CodeLength:       8,
}))

---

Full Setup

All modules together:

a, _ := auth.New(&config.Config{
    Storage:     store,
    AutoMigrate: true,
    BasePath:    "/api/v1",
    Security: types.SecurityConfig{
        JwtSecretKey:  os.Getenv("JWT_SECRET_KEY"),
        EncryptionKey: os.Getenv("ENCRYPTION_KEY"),
        Session: types.SessionConfig{
            AccessTokenTTL:  15 * time.Minute,
            RefreshTokenTTL: 7 * 24 * time.Hour,
        },
    },
    Core: &config.CoreConfig{
        RequireEmailVerification: true,
    },
    CORS: &config.CORSConfig{
        Enabled:        true,
        AllowedOrigins: []string{"http://localhost:3000"},
    },
})

a.Use(notification.New(&notification.Config{...}))
a.Use(twofactor.New(&twofactor.TwoFactorConfig{...}))
a.Use(captcha.New(&captcha.CaptchaConfig{...}))
a.Use(csrf.New(&csrf.CSRFConfig{...}))
a.Use(admin.New(nil, nil))

a.Initialize(context.Background())

r := gin.Default()
ginadapter.Register(r, a)
r.Run(":8080")

---

Demo App

A Next.js demo frontend is included in the demo/ directory. See the demo README for setup.