💰 Modern Enterprise Banking Platform - Complete Financial Infrastructure
A next-generation enterprise banking platform providing comprehensive financial services, treasury management, secure banking integration, and multi-account management with a modern Qonto-inspired consumer interface.
🚀 Quick Start • 📋 What's New • 📊 Current Status • 🛠️ Tech Stack • 📁 Architecture • 🤝 Contributing
Aether Bank is a comprehensive enterprise banking platform that has evolved significantly from its initial concept. Starting as a hybrid Go/TypeScript architecture, it has grown into a complete ecosystem featuring authentication, multi-language support, user banking dashboards, and enterprise-ready admin capabilities.
- 🚀 Hybrid Architecture - Go 1.21+ backend + TypeScript 5 frontend
- 💰 Complete Banking Features - Accounts, transactions, cards, transfers, savings, credits
- 🏢 Multi-Tenant Platform - User dashboard + Admin platform
- ⚡ High-Performance Backend - Go-based server with Gin + GORM + PostgreSQL
- 🎨 Modern Frontend - Next.js 16 + React 19 + shadcn/ui + Tailwind CSS v4
- 🌍 Internationalization - Multi-language support (FR, EN, ES, DE, CH, BE)
- 🔐 Secure Authentication - JWT-based system with login/register forms and context
- 🏗️ Enterprise-Ready Design - Scalable, secure, and maintainable architecture
- 📚 Comprehensive Documentation - Complete API references and guides
- 🛠️ Developer-Friendly - Make commands, hot reload, TypeScript strict mode
- ✅ User Banking Dashboard - Complete account management interface
- ✅ Transaction Management - Full transaction history and filtering
- ✅ Card Management - Virtual and physical card controls
- ✅ Transfer System - Internal and external transfer capabilities
- ✅ Savings Accounts - Savings goals and interest tracking
- ✅ Credit Management - Credit lines and loan tracking
- ✅ Team Management - Multi-user team access control
- ✅ Admin Dashboard - Comprehensive platform statistics
- ✅ Real-time Analytics - Charts and transaction monitoring
- ✅ Alert Management - System alerts and notifications
- ✅ User Management - Complete platform user administration
- ✅ Qonto-Inspired Design - Modern French banking interface
- ✅ Responsive Sidebar - Fixed sidebar with independent scroll
- ✅ Mega Menu Navigation - Comprehensive navigation system
- ✅ Dark Mode Support - Theme provider integration
- ✅ Multi-Language Support - French, English, Spanish, German, Swiss French, Belgian Dutch
- ✅ Localized Content - Country-specific banking content
- ✅ RTL Support Preparation - Future-proof architecture
✅ Rapid Evolution: From basic hybrid architecture to complete banking platform with admin dashboard.
- ✅ Hybrid Monorepo Architecture - Go backend + TypeScript frontend workspaces
- ✅ Go Backend Server - High-performance Gin API with GORM + PostgreSQL
- ✅ Next.js 16 Frontend - Modern React 19 with shadcn/ui + Tailwind CSS v4
- ✅ Database Layer - GORM with PostgreSQL and user models
- ✅ JWT Authentication - Complete implementation with login/register forms
- ✅ Auth Context - Global authentication state management in React
- ✅ User Dashboard - Complete account overview with balance display
- ✅ Account Management - IBAN/BIC display with copy functionality
- ✅ RIB Download - PDF bank details export
- ✅ Transaction History - Full transaction list with filtering
- ✅ Card Management - Virtual card display and controls
- ✅ Transfer System - Money transfer interface
- ✅ Savings Accounts - Savings goals and tracking
- ✅ Credit Lines - Credit management interface
- ✅ Team Management - Multi-user team features
- ✅ Platform Dashboard - Comprehensive statistics view
- ✅ Analytics Charts - Visual data representation
- ✅ Transaction Monitoring - Real-time transaction feed
- ✅ Alert System - Platform alerts and notifications
- ✅ Multi-Language Support - 6 languages supported
- ✅ Localized Navigation - Country-specific content
- ✅ Translation System - next-intl integration
- ✅ Development Environment - Hot reload, TypeScript strict mode, Go modules
- ✅ Docker Deployment - Production-ready containers
- ✅ Security Implementation - CORS, rate limiting, security headers
- ✅ Structured Logging - Pino-based logging with correlation
- Payment Processing - Integration with payment gateways
- Advanced Analytics - Deeper financial insights
- API Documentation - Comprehensive API docs and testing
- Testing Suite - Unit and integration tests
- Mobile Application - React Native companion app
- Advanced Security - 2FA, biometrics, fraud detection
- Investment Features - Stock and crypto trading
- Insurance Products - Integrated insurance offerings
- Accounting Integration - Bookkeeping software connection
- Go 1.21.0 or higher (for backend)
- Node.js 18.0.0 or higher (for frontend)
- pnpm 9.0.0 or higher (recommended package manager)
- PostgreSQL 14.0 or higher (for database)
- Docker (optional, for deployment)
- Make (for command shortcuts - included with most systems)
-
Clone the repository
git clone https://github.com/skygenesisenterprise/aether-bank.git cd aether-bank -
Quick start (recommended)
# One-command setup and start make quick-start -
Manual setup
# Install Go dependencies cd server && go mod download && cd .. # Install Node.js dependencies make install # Environment setup make env-dev # Database initialization make db-migrate # Start development servers make dev
Once running, you can access:
- Frontend: http://localhost:3000
- API Server: http://localhost:8080
- Health Check: http://localhost:8080/health
- Public Homepage: http://localhost:3000/fr
- User Dashboard: http://localhost:3000/user/home
- Platform Admin: http://localhost:3000/dashboard
# 🚀 Quick Start & Development
make quick-start # Install, migrate, and start dev servers
make dev # Start all services (frontend + backend)
make dev-frontend # Frontend only (port 3000)
make dev-backend # Backend only (port 8080)
# 🏗️ Building & Production
make build # Build all packages
make build-frontend # Frontend production build
make start # Start production servers
# 🗄️ Database
make db-studio # Open Prisma Studio
make db-migrate # Run migrations
make db-seed # Seed development data
# 🔧 Code Quality & Testing
make lint # Lint all packages
make typecheck # Type check all packages
make format # Format code with Prettier
# 🛠️ Utilities
make help # Show all available commands
make status # Show project status
make health # Check service health💡 Tip: Run
make helpto see all available commands organized by category.
Next.js 16 + React 19 + TypeScript 5
├── 🎨 Tailwind CSS v4 + shadcn/ui (Styling & Components)
├── 🔐 JWT Authentication (Complete Implementation)
├── 🛣️ Next.js App Router (Routing)
├── 📝 TypeScript Strict Mode (Type Safety)
├── 🌐 next-intl (Internationalization)
├── 🔄 React Context (State Management)
├── 📊 Recharts (Data Visualization)
└── 🔧 ESLint + Prettier (Code Quality)
Go 1.21+ + Gin Framework
├── 🗄️ GORM + PostgreSQL (Database Layer)
├── 🔐 JWT Authentication (Complete Implementation)
├── 🛡️ Middleware (Security, CORS, Logging)
├── 🌐 HTTP Router (Gin Router)
├── 📦 JSON Serialization (Native Go)
└── 📊 Structured Logging (Zerolog)
PostgreSQL + GORM
├── 🏗️ Schema Management (Auto-migration)
├── 🔍 Query Builder (Type-Safe Queries)
├── 🔄 Connection Pooling (Performance)
├── 👤 User Models (Complete Implementation)
└── 📈 Seed Scripts (Development Data)
Make + pnpm Workspaces + Go Modules
├── 📦 app/ (Next.js Frontend - TypeScript)
├── ⚙️ server/ (Gin API - Go)
├── 🗂️ models/ (Data Models)
├── 🗄️ prisma/ (Database Schema)
└── 🐳 docker/ (Container Configuration)
aether-bank/
├── app/ # Next.js 16 Frontend Application (TypeScript)
│ ├── app/ # Next.js App Router
│ │ ├── (public)/ # Public marketing pages
│ │ │ ├── [locale]/ # Localized homepage
│ │ │ ├── compte-pro/
│ │ │ ├── compte-particulier/
│ │ │ ├── epargne/
│ │ │ ├── cartes/
│ │ │ ├── credit/
│ │ │ └── pgp/
│ │ ├── (user)/ # User banking dashboard
│ │ │ └── user/
│ │ │ ├── home/
│ │ │ ├── account/
│ │ │ ├── transactions/
│ │ │ ├── cards/
│ │ │ ├── transferts/
│ │ │ ├── savings/
│ │ │ ├── credit/
│ │ │ ├── team/
│ │ │ ├── security/
│ │ │ ├── management/
│ │ │ ├── settings/
│ │ │ └── help/
│ │ ├── (platform)/ # Admin platform
│ │ │ └── dashboard/
│ │ └── (auth)/ # Authentication pages
│ │ ├── login/
│ │ └── register/
│ ├── components/ # React components
│ │ ├── ui/ # shadcn/ui component library
│ │ ├── bank/ # Banking components
│ │ ├── user/ # User dashboard components
│ │ └── platform/ # Admin platform components
│ ├── context/ # React contexts
│ │ ├── JwtAuthContext.tsx
│ │ ├── AuthContext.tsx
│ │ └── LocaleContext.tsx
│ ├── lib/ # Utility functions
│ ├── hooks/ # Custom React hooks
│ ├── config/ # Configuration
│ ├── messages/ # Translation files
│ │ ├── fr.json # French
│ │ ├── en.json # English
│ │ ├── es.json # Spanish
│ │ ├── de.json # German
│ │ ├── ch_fr.json # Swiss French
│ │ └── be_nl.json # Belgian Dutch
│ │ └── be_fr.json # Belgian French
│ └── styles/ # Global styles
├── server/ # Go Backend Server
│ ├── cmd/
│ │ └── server/
│ │ └── main.go # CLI entry point
│ ├── src/
│ │ ├── config/ # Database and server configuration
│ │ ├── controllers/ # HTTP request handlers
│ │ ├── middleware/ # Gin middleware
│ │ ├── models/ # Data models and structs
│ │ ├── routes/ # API route definitions
│ │ ├── services/ # Business logic
│ │ └── utils/ # Utility functions
│ ├── prisma/ # Database schema
│ ├── main.go # Main server entry point
│ ├── go.mod # Go modules file
│ └── go.sum # Go modules checksum
├── models/ # Shared Data Models
├── services/ # Core Services
├── docker/ # Docker Configuration
├── Makefile # Build automation
└── README.md # Project documentation
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Next.js App │ │ Gin API │ │ PostgreSQL │
│ (Frontend) │◄──►│ (Backend) │◄──►│ (Database) │
│ Port 3000 │ │ Port 8080 │ │ Port 5432 │
│ TypeScript │ │ Go │ │ │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
JWT Tokens API Endpoints User/Account Data
React Context Authentication GORM ORM
shadcn/ui Components Business Logic Auto-migrations
│ │
▼ ▼
┌─────────────────┐ ┌──────────────────┐
│ User Dashboard │ │ Platform Admin │
│ Banking Features│ │ Analytics │
│ Transactions │ │ User Management │
│ Cards & Transfers│ │ Alerts │
└─────────────────┘ └──────────────────┘
- ✅ Hybrid Monorepo Setup - Go backend + TypeScript frontend workspaces
- ✅ Authentication System - Complete JWT implementation with forms
- ✅ Frontend Framework - Next.js 16 + React 19 + shadcn/ui
- ✅ Go Backend API - Gin with authentication endpoints
- ✅ Database Layer - GORM with PostgreSQL and user models
- ✅ Development Environment - TypeScript strict mode, Go modules, hot reload
- ✅ User Dashboard - Complete banking interface
- ✅ Account Management - IBAN/BIC display and RIB download
- ✅ Transaction System - Full transaction history
- ✅ Card Management - Virtual card interface
- ✅ Transfer System - Money transfer capabilities
- ✅ Savings & Credit - Financial product interfaces
- ✅ Admin Dashboard - Platform statistics
- ✅ Analytics Charts - Visual data representation
- ✅ Alert Management - System notifications
- ✅ User Administration - Platform user management
- 🔄 Payment Processing - Payment gateway integration
- 🔄 Advanced Analytics - Deeper financial insights
- 📋 API Documentation - Comprehensive API docs
- 📋 Testing Suite - Unit and integration tests
- 📋 Mobile Application - React Native companion app
- 📋 Advanced Security - 2FA, biometrics, fraud detection
- 📋 Investment Features - Stock and crypto trading
- 📋 Insurance Products - Integrated insurance offerings
# New developer setup
make quick-start
# Daily development
make dev # Start working (Go + TypeScript)
make lint-fix # Fix code issues
make typecheck # Verify types
# Go-specific development
cd server
go run main.go # Start Go server
go test ./... # Run Go tests
go fmt ./... # Format Go code
go mod tidy # Clean dependencies
# TypeScript-specific development
make dev-frontend # Frontend only
make lint # Check code quality
make typecheck # Verify types
# Before committing
make format # Format code
make lint # Check code quality
make typecheck # Verify types
# Database changes
make db-migrate # Apply migrations
make db-studio # Browse database
# Production deployment
make build # Build everything
make docker-build # Create Docker image
make docker-run # Deploy- Make-First Workflow - Use
makecommands for all operations - Go Best Practices - Follow Go conventions for backend code
- TypeScript Strict Mode - All frontend code must pass strict type checking
- Conventional Commits - Use standardized commit messages
- Component Structure - Follow established patterns for React components
- API Design - RESTful endpoints with proper HTTP methods
- Error Handling - Comprehensive error handling and logging
- Security First - Validate all inputs and implement proper authentication
The authentication system is fully implemented with Go backend and TypeScript frontend:
- JWT Tokens - Secure token-based authentication with refresh mechanism
- Login/Register Forms - Complete user authentication flow with validation
- Auth Context - Global authentication state management in React
- Protected Routes - Route-based authentication guards
- Go API Endpoints - Complete authentication API with Gin framework
- Password Security - bcrypt hashing for secure password storage
- Session Management - LocalStorage-based session persistence
// Go Backend Registration Process
1. User submits registration → API validation
2. Password hashing with bcrypt → Database storage
3. JWT tokens generated → Client receives tokens
4. Auth context updates → User logged in
// Go Backend Login Process
1. User submits credentials → API validation
2. Password verification → JWT token generation
3. Tokens stored → Auth context updated
4. Redirect to dashboard → Protected route access
// Token Refresh
1. Background token refresh → Automatic renewal
2. Invalid tokens → Redirect to login
3. Session expiration → Clean logout
Aether Bank supports multiple languages for international users:
- 🇫🇷 French (fr) - Primary language
- 🇬🇧 English (en)
- 🇪🇸 Spanish (es)
- 🇩🇪 German (de)
- 🇨🇭 Swiss French (ch_fr)
- 🇧🇪 Belgian Dutch (be_nl)
- 🇧🇪 Belgian French (be_fr)
// Using next-intl for translations
import { useTranslations } from 'next-intl';
const t = useTranslations('Navigation');
return <h1>{t('home')}</h1>;We're looking for contributors to help build this comprehensive banking platform! Whether you're experienced with Go, TypeScript, React, banking systems, web development, or security, there's a place for you.
- Fork the repository and create a feature branch
- Check the issues for tasks that need help
- Join discussions about architecture and features
- Start small - Documentation, tests, or minor features
- Follow our code standards and commit guidelines
- Go Backend Development - API endpoints, business logic, security
- TypeScript Frontend Development - React components, UI/UX design, dashboard
- Banking Features - Payment processing, transaction handling
- Database Design - Schema development, migrations, optimization
- Security Specialists - Authentication, encryption, fraud detection
- DevOps Engineers - Docker, deployment, CI/CD for hybrid stack
- UI/UX Designers - Banking interface design, user experience
- Documentation - API docs, user guides, tutorials
- Choose an area - Core server, frontend, or specific feature
- Read the docs - Understand project conventions
- Create a branch with a descriptive name
- Implement your changes following our guidelines
- Test thoroughly in all relevant environments
- Submit a pull request with clear description and testing
- Address feedback from maintainers and community
- 📖 Documentation - Comprehensive guides and API docs
- 🐛 GitHub Issues - Bug reports and feature requests
- 💡 GitHub Discussions - General questions and ideas
- 📧 Email - support@skygenesisenterprise.com
When reporting bugs, please include:
- Clear description of the problem
- Steps to reproduce
- Environment information (Go version, Node.js version, OS, etc.)
- Error logs or screenshots
- Expected vs actual behavior
| Component | Status | Technology | Notes |
|---|---|---|---|
| Hybrid Architecture | ✅ Working | Go + TypeScript | Monorepo with workspaces |
| Authentication System | ✅ Working | JWT (Go/TS) | Full implementation with forms |
| Go Backend API | ✅ Working | Gin + GORM | High-performance with PostgreSQL |
| Frontend Framework | ✅ Working | Next.js 16 + React 19 | shadcn/ui + Tailwind CSS v4 |
| User Dashboard | ✅ Working | TypeScript + React | Complete banking interface |
| Platform Admin | ✅ Working | TypeScript + React | Admin dashboard with analytics |
| Banking Features | ✅ Working | TypeScript | Accounts, cards, transfers |
| Internationalization | ✅ Working | next-intl | 7 languages supported |
| UI Component Library | ✅ Working | shadcn/ui + Tailwind CSS | Complete component set |
| Database Layer | ✅ Working | GORM + PostgreSQL | Auto-migrations + user models |
| Docker Deployment | ✅ Working | Multi-Stage | Production-ready containers |
| Payment Processing | 🔄 In Progress | Go/TS | Gateway integration |
| Mobile Application | 📋 Planned | React Native | Future companion app |
| Testing Suite | 📋 Planned | Go/TS | Unit and integration tests |
| Documentation | ✅ Working | Go/TS | README and guides |
Development led by Sky Genesis Enterprise
We're looking for sponsors and partners to help accelerate development of this open-source banking platform.
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2025 Sky Genesis Enterprise
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
- Sky Genesis Enterprise - Project leadership and evolution
- Go Community - High-performance programming language and ecosystem
- Gin Framework - Lightweight HTTP web framework
- GORM Team - Modern Go database library
- Next.js Team - Excellent React framework
- React Team - Modern UI library
- shadcn/ui - Beautiful component library
- Tailwind CSS - Utility-first CSS framework
- pnpm - Fast, disk space efficient package manager
- Make - Universal build automation and command interface
- Docker Team - Container platform and tools
- Open Source Community - Tools, libraries, and inspiration
⭐ Star This Repo • 🐛 Report Issues • 💡 Start a Discussion
💰 Modern Enterprise Banking Platform with Complete Financial Infrastructure!
Made with ❤️ by the Sky Genesis Enterprise team
Building the future of enterprise banking with complete authentication, banking features, and admin capabilities
