Skip to content

README.md

Latest commit

 

History

History
147 lines (115 loc) · 4.39 KB

README.md

File metadata and controls

147 lines (115 loc) · 4.39 KB

🌸 Sakura Dreams — Japanese 3D Authentication

Go Fiber SQLite Tailwind Alpine.js Render

🎌 Tranquil Japanese cherry blossom authentication with falling petals, moonlit night, floating lanterns, and zen garden aesthetics. Fully responsive design!

✨ Features

  • 🌙 Moonlit Night Sky — Glowing moon with crater details
  • 🌸 Falling Sakura Petals — Dynamic CSS-animated cherry blossoms
  • 🏮 Floating Lanterns — Traditional Japanese paper lanterns
  • 🎏 Koi Pond — Water ripples with swimming koi fish
  • 🎋 Cherry Blossom Branches — Decorative sakura tree elements
  • ✨ 3D Glassmorphism Cards — Subtle breathing animations
  • ⚡ Real-time Validation — Async field validation via API
  • 🔐 Secure Auth — bcrypt password hashing
  • 📧 Email Auth — Login and register with email
  • 💪 Password Strength Meter — Visual strength indicator
  • 📱 Fully Responsive — Mobile-first design
  • 🚀 Zero Page Reloads — All errors handled via AJAX

🛠 Tech Stack

Layer Technology
Backend Go 1.21+ with Fiber v2
Database SQLite (Pure Go, no CGO)
ORM GORM
Frontend Alpine.js 3.x
Styling Tailwind CSS 3.x
Auth bcrypt + Sessions

🚀 Quick Start

Clone and run:

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

Initialize and start:

go mod tidy
go run .

Open http://localhost:3000

🔑 Demo Account

Field Value
Email demo@sakura.app
Password demo1234

📁 Project Structure

go-fiber-auth-sakura/
├── main.go              # Fiber server, routes, handlers
├── templates/
│   ├── login.html       # Email login with sakura theme
│   ├── register.html    # Email registration
│   └── dashboard.html   # Responsive zen dashboard
├── sakura_auth.db       # SQLite database (auto-created)
├── render.yaml          # Render deployment config
└── README.md

🎨 Visual Elements

Sakura Petals

  • 35 petals on desktop, 20 on mobile
  • Unique fall trajectories with sway
  • Random sizes and animation delays
  • Soft pink gradient colors with glow

Moon

  • Radial gradient for 3D effect
  • Crater details via pseudo-elements
  • Pulsing glow animation
  • Responsive sizing

Koi Fish

  • Swimming animation across pond
  • Orange-gold gradient
  • Hidden on mobile for performance

Lanterns

  • Floating animation
  • Warm glow effect
  • Responsive visibility

🔒 Security Features

  • bcrypt password hashing (cost 10)
  • HTTP-only session cookies
  • Server-side validation
  • SQL injection protected via GORM
  • XSS protected via template escaping

📱 Responsive Design

  • Mobile-first approach
  • Adaptive petal count (20 mobile / 35 desktop)
  • Collapsible header elements
  • Touch-friendly inputs
  • Optimized animations for mobile

🌐 API Endpoints

Method Endpoint Description
GET / Redirect to /login
GET /login Login page
POST /api/login Authenticate user
GET /register Registration page
POST /api/register Create account
POST /api/validate/email Check email available (register)
POST /api/validate/email-exists Check email exists (login)
GET /dashboard Protected dashboard
POST /logout End session

🎯 Dependencies

github.com/glebarez/sqlite
github.com/gofiber/fiber/v2
github.com/gofiber/fiber/v2/middleware/logger
github.com/gofiber/fiber/v2/middleware/session
github.com/gofiber/template/html/v2
golang.org/x/crypto
gorm.io/gorm

Deploy in 10 seconds

Deploy to Render