🏆 Akunuba - Luxury Wealth & Lifestyle Management Platform

A comprehensive wealth management platform for high-net-worth individuals and entrepreneurs

Features • Getting Started • Deployment • Tech Stack

📖 About

Akunuba is a luxury wealth and lifestyle management platform designed for high-net-worth individuals and entrepreneurs. It combines investment tracking, asset management, estate planning, and exclusive marketplace access into one AI-powered dashboard, making it easy to grow, manage, and protect generational wealth.

Key Highlights

💼 Comprehensive Asset Management - Track and manage all your assets in one place
📊 Advanced Portfolio Analytics - Real-time insights and performance tracking
🏪 Exclusive Marketplace - Access to premium investment opportunities
📄 Document Management - Secure storage and organization of financial documents
🎯 Wealth Structure Planning - Entity structure and compliance management
📈 Real-time Reporting - Detailed reports and analytics for informed decisions

✨ Features

🎯 Core Features

Dashboard Overview
- Real-time net worth tracking
- Asset allocation visualization
- Performance analytics with interactive charts
- Available liquidity monitoring
Asset Management
- Comprehensive asset tracking (Real Estate, Stocks, Crypto, etc.)
- Asset detail pages with valuation history
- Document association and management
- Appraisal and sale request workflows
Portfolio Management
- Portfolio overview with performance metrics
- Asset allocation breakdown (Pie charts, area charts)
- Top holdings analysis
- Cash flow forecasting
- Trade engine for active trading
Marketplace
- Browse exclusive investment opportunities
- Filter by asset type, risk level, and returns
- Detailed investment opportunity pages
- Investment tracking
Reports & Documents
- Generate comprehensive financial reports
- Document upload and management
- Secure document sharing
- Report scheduling and automation
Wealth Structure
- Entity structure management
- Compliance tracking
- Legal document organization

🎨 UI/UX Features

Modern Design System
- Dark/light theme support
- Responsive design (mobile, tablet, desktop)
- Smooth animations with Framer Motion
- Glass morphism effects
- Interactive charts with Recharts
User Experience
- Intuitive navigation with sidebar menu
- Real-time notifications
- Profile management
- Search functionality
- Modal workflows for actions

🛠️ Tech Stack

Frontend

Framework: Next.js 16.0.1 with App Router
UI Library: React 19.2.0
Styling: Tailwind CSS 4.0
Animations: Framer Motion 12.23.24
Charts: Recharts 2.13.3
Animations: GSAP 3.13.0

Build & Deployment

Static Export: Configured for Cloudflare Pages
Build Tool: Next.js with Turbopack
Deployment: Cloudflare Pages

Development Tools

Linting: ESLint with Next.js config
Package Manager: npm
Node Version: >=20.9.0

🚀 Getting Started

Prerequisites

Node.js >= 20.9.0
npm >= 10.0.0

Installation

Clone the repository

git clone https://github.com/yourusername/akunuba.git
cd akunuba

Install dependencies
```
npm install
```
Run the development server
```
npm run dev
```
Open your browser Navigate to http://localhost:3000

Available Scripts

# Development
npm run dev          # Start development server

# Production
npm run build        # Build for production
npm start            # Start production server

# Deployment
npm run pages:build  # Build for Cloudflare Pages
npm run pages:deploy # Deploy to Cloudflare Pages
npm run cf:deploy    # Build and deploy in one command

# Code Quality
npm run lint         # Run ESLint

📁 Project Structure

akunuba/
├── src/
│   ├── app/                    # Next.js App Router pages
│   │   ├── dashboard/         # Dashboard pages
│   │   │   ├── assets/        # Asset management
│   │   │   ├── portfolio/     # Portfolio management
│   │   │   ├── marketplace/   # Investment marketplace
│   │   │   ├── reports/       # Reports & analytics
│   │   │   └── documents/     # Document management
│   │   ├── about/             # About page
│   │   └── layout.js          # Root layout
│   ├── components/            # React components
│   │   ├── dashboard/         # Dashboard components
│   │   ├── layout/            # Layout components
│   │   ├── ui/                # UI components
│   │   └── sections/          # Page sections
│   ├── context/               # React context providers
│   └── app/globals.css      # Global styles
├── public/                     # Static assets
├── next.config.mjs            # Next.js configuration
├── tailwind.config.js         # Tailwind CSS configuration
├── jsconfig.json              # JavaScript path aliases
└── package.json               # Dependencies

🌐 Deployment

Cloudflare Pages Deployment

This project is configured for static export and deployment on Cloudflare Pages.

Build Settings

Framework preset: Next.js (Static HTML Export)
Build command: npm run build
Build output directory: out
Root directory: /

Deployment Methods

Option 1: Via Cloudflare Dashboard (Recommended)

Go to Cloudflare Dashboard
Navigate to Workers & Pages → Create application → Pages
Connect your Git repository
Configure build settings as above
Deploy automatically on every push

Option 2: Via Wrangler CLI

# Login to Cloudflare
npx wrangler login

# Build and deploy
npm run cf:deploy

For detailed deployment instructions, see CLOUDFLARE_DEPLOY.md

🎨 Features Showcase

Dashboard

Real-time net worth tracking
Interactive performance charts
Asset allocation visualization
Quick access to all features

Asset Management

Add, view, and manage assets
Detailed asset pages with images
Valuation history tracking
Document association
Appraisal and sale workflows

Portfolio Analytics

Performance metrics
Asset allocation breakdown
Top holdings analysis
Cash flow forecasting

Marketplace

Browse investment opportunities
Filter by multiple criteria
Detailed opportunity pages
Investment tracking

🔧 Configuration

Environment Variables

Create a .env.local file for local development (if needed):

# Add your environment variables here

Path Aliases

The project uses path aliases configured in jsconfig.json:

{
  "compilerOptions": {
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

This allows imports like:

import Component from '@/components/Component';

📝 Development Guidelines

Code Style

Use ESLint configuration provided
Follow React best practices
Use functional components with hooks
Implement proper error handling

Component Structure

Keep components modular and reusable
Use TypeScript-style prop validation
Implement proper loading and error states

Styling

Use Tailwind CSS utility classes
Follow the design system
Ensure responsive design
Support dark/light themes

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

📞 Support

For support, email support@akunuba.com or open an issue in the repository.

🙏 Acknowledgments

Next.js - The React Framework
Tailwind CSS - Utility-first CSS framework
Framer Motion - Animation library
Recharts - Chart library
Cloudflare Pages - Hosting platform

Built with ❤️ using Next.js and Tailwind CSS

⭐ Star this repo if you find it helpful!

Name		Name	Last commit message	Last commit date
Latest commit History 48 Commits
public		public
src		src
.gitignore		.gitignore
.node-version		.node-version
.nvmrc		.nvmrc
README.md		README.md
eslint.config.mjs		eslint.config.mjs
jsconfig.json		jsconfig.json
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.js		tailwind.config.js
wrangler.toml		wrangler.toml

teklabspace/fullego

Folders and files

Latest commit

History

Repository files navigation