Skip to content

smart-developer1791/go-fiber-auth-koi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1 Commit
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽ Zen Koi Pond

Go Version Fiber GORM Tailwind CSS Alpine.js Render

Tranquil Japanese Koi Pond 3D authentication system with swimming koi fish, water ripples, lotus flowers, floating petals, and zen aesthetics. Immersive visual experience with real-time validation.

โœจ Features

  • ๐ŸŸ Animated Koi Fish โ€” Graceful SVG koi swimming with tail animations
  • ๐ŸŒŠ Water Ripples โ€” Expanding circle effects across the pond surface
  • ๐ŸŒธ Lotus Flowers โ€” Blooming lotus with gentle breathing animation
  • ๐ŸŒธ Falling Petals โ€” Cherry blossom petals drifting down
  • ๐Ÿฆ‹ Dragonflies โ€” Hovering insects with rapid wing beats
  • ๐Ÿฎ Paper Lanterns โ€” Traditional Japanese lanterns with kanji
  • ๐Ÿ” Secure Auth โ€” bcrypt password hashing with session management
  • โšก Real-time Validation โ€” Async email checking + password strength meter
  • ๐ŸŽจ Glassmorphism UI โ€” Frosted glass cards with backdrop blur
  • ๐Ÿ“ฑ Fully Responsive โ€” Beautiful on all screen sizes
  • ๐Ÿš€ No CGO Required โ€” Pure Go SQLite driver

๐Ÿ› ๏ธ Tech Stack

Layer Technology
Backend Go 1.21+, Fiber v2
Database GORM + Pure Go SQLite
Frontend Alpine.js 3.x, Tailwind CSS
Auth bcrypt, Secure Sessions
Deploy Render.com Ready

๐Ÿš€ Quick Start

Clone the repository:

git clone https://github.com/smart-developer1791/go-fiber-auth-koi
cd go-fiber-auth-koi

Install dependencies and run:

go mod tidy
go run .

Open http://localhost:3000

๐Ÿ”‘ Demo Account

Field Value
Email demo@koipond.zen
Password demo123456
Phone +1 (555) 867-5309

๐Ÿ“ Project Structure

go-fiber-auth-koi/
โ”œโ”€โ”€ main.go              # Fiber server, routes, auth logic
โ”œโ”€โ”€ go.mod               # Go module dependencies
โ”œโ”€โ”€ render.yaml          # Render deployment config
โ”œโ”€โ”€ .gitignore           # Git ignore rules
โ”œโ”€โ”€ README.md            # Documentation
โ””โ”€โ”€ templates/
    โ”œโ”€โ”€ login.html       # Login page with koi animations
    โ”œโ”€โ”€ register.html    # Register with lotus theme
    โ””โ”€โ”€ dashboard.html   # Zen sanctuary dashboard

๐ŸŽจ Visual Effects

Koi Fish

  • Multiple colors: Orange, White, Golden, Black, Red
  • Realistic swimming patterns with CSS animations
  • Tail fin wave animation
  • Depth layering with z-index

Water Effects

  • Expanding ripple circles
  • Water surface shimmer
  • Translucent lily pads

Zen Elements

  • Paper lanterns with kanji (็ฆ…/้ฏ‰/่“ฎ)
  • Lotus flowers with bloom animation
  • Floating cherry blossom petals
  • Dragonflies with wing beats

๐Ÿ”’ Security Features

  • bcrypt password hashing (cost factor 10)
  • HTTP-only session cookies
  • CSRF-safe SameSite cookie policy
  • Input sanitization on all fields
  • Async email validation prevents duplicates

๐ŸŒ API Endpoints

Method Endpoint Description
GET / Login page
GET /login Login page
GET /register Register page
GET /dashboard Protected dashboard
POST /api/login Authenticate user
POST /api/register Create new user
POST /api/logout End session
POST /api/validate Real-time field validation

๐Ÿšข Deployment

Environment Variables

Variable Default Description
PORT 3000 Server port

๐Ÿ“œ Kanji Meanings

Kanji Reading Meaning
้ฏ‰ Koi Carp fish
็ฆ… Zen Meditation
่“ฎ Ren Lotus

Deploy in 10 seconds

Deploy to Render

About

๐ŸŽ Zen Koi Pond โ€” Tranquil Japanese 3D authentication with swimming koi fish, water ripples, lotus flowers, floating petals, and paper lanterns. Go Fiber + GORM + SQLite + Alpine.js + Tailwind CSS. No CGO required!

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors