WealthVN

A Beautiful Portfolio Tracker for Vietnamese Market | Ứng dụng Theo dõi Danh mục Đầu tư cho Thị trường Việt Nam

GitHub · Releases · Issues

WealthVN - Quản lý tài chính & đầu tư cá nhân thông minh

Tất cả tài sản – Một nơi duy nhất

WealthVN giúp bạn theo dõi, quản lý và phát triển danh mục đầu tư một cách trực quan – chính xác – dễ sử dụng, được thiết kế riêng cho nhà đầu tư Việt Nam.

• Quản lý toàn bộ danh mục đầu tư Cổ phiếu, quỹ đầu tư, tiền mặt, trái phiếu… tất cả được tổng hợp trong một dashboard duy nhất.

• Theo dõi hiệu suất & tăng trưởng theo thời gian Biểu đồ trực quan giúp bạn nắm rõ lãi/lỗ, tăng trưởng YTD, và giá trị tài sản ròng.

• Lịch sử giao dịch chi tiết Quản lý từng giao dịch mua/bán, phí, giá vốn cho từng tài sản.

• Phân tích danh mục thông minh Phân bổ theo tài sản, tài khoản, ngành nghề và quốc gia – rõ ràng chỉ trong vài giây.

• Quản lý mục tiêu tài chính Lập kế hoạch cho các mục tiêu lớn như mua nhà, mua xe, nghỉ hưu, kèm dự phóng tăng trưởng.

• Hỗ trợ dữ liệu thị trường Việt Nam Tích hợp giá cổ phiếu, quỹ, và dữ liệu thị trường từ các nguồn uy tín.

• Giao diện hiện đại, dễ tuỳ chỉnh Light/Dark mode, nhiều màu chủ đề, trải nghiệm mượt mà trên mọi thiết bị.

• Nhà đầu tư cá nhân tại Việt Nam
• Người muốn quản lý tài chính cá nhân một cách bài bản
• Người có nhiều tài sản & mục tiêu tài chính dài hạn

WealthVN hiện tại là open source app, với ngân sách hạn chế, nên khi bạn cài đặt, bạn sẽ thấy thông báo cảnh báo app chưa được đăng ký (Chưa có tiền đăng ký ).

• Trên Windows bạn có thể tắt thông báo này
• Trên MacOS bạn có thể tắt thông báo này trong cài đặt. Dùng lệnh sau:

    xattr -d com.apple.quarantine /Applications/WealthVN.app
  

• Trên Linux bạn có thể cài app một cách bình thường.

Quản lý tài chính không cần phức tạp. Chỉ cần đúng công cụ.

Bắt đầu xây dựng tương lai tài chính của bạn cùng WealthVN.

Được fork từ Wealthfolio của Aziz Fadil.

WealthVN is a Beautiful Portfolio Tracker designed for the Vietnamese market, with Local Data Storage. No Subscriptions, No Cloud.

• Portfolio Tracking - Track your investments across multiple accounts and asset types
• Performance Analytics - Detailed performance metrics and historical analysis
• Activity Management - Import and manage all your trading activities
• Goal Planning - Set and track financial goals with allocation management
• Local Data - All data stored locally with no cloud dependencies
• Extensible - Powerful addon system for custom functionality
• Multi-Currency - Support for multiple currencies with exchange rate management
• Multi-Language - Full internationalization support (English, Vietnamese)
• Cross-Platform - Available on Windows, macOS, and Linux
• VN Market Support - Built-in support for Vietnamese stock market data

Ensure you have the following installed on your machine:

• Node.js
• pnpm
• Rust
• Tauri

1. Clone the repository:

   git clone https://github.com/chipheo00/vn-wealthfolio.git
   cd vn-wealthfolio

2. Install dependencies using pnpm:

   pnpm install

3. Setup environment configuration:

   Copy the environment template and configure it for your setup:

   cp .env.example .env

4. Run in Development Mode:

   Build and run the desktop application using Tauri:

   pnpm tauri dev

5. Build for Production:

   Build the application for production:

   pnpm tauri build

Run the web UI with a local Axum server with one command.

1. Setup environment (optional but recommended):

   cp .env.web.example .env.web

2. Start both backend and Vite dev server:

   pnpm run dev:web

   The Vite dev server runs at http://localhost:1420 and proxies API calls to the Axum backend server.

Build and run with Docker:

# Build the image
docker build -t wealthvn .

# Run the container
docker run --rm -d \
  --name wealthvn \
  -e WF_LISTEN_ADDR=0.0.0.0:8088 \
  -e WF_DB_PATH=/data/wealthvn.db \
  -p 8088:8088 \
  -v "$(pwd)/wealthvn-data:/data" \
  wealthvn

Access the application at http://localhost:8088 after starting the container.

• React: JavaScript library for building user interfaces.
• React Router: Declarative routing for React.
• Tailwind CSS: Utility-first CSS framework for styling.
• Radix UI/Shadcn: Accessible UI components.
• Recharts: Charting library built with React.
• React Query: Data-fetching library for React.
• Zod: TypeScript-first schema declaration and validation library.

• Tauri: Framework for building tiny, secure, and fast desktop applications.
• Rust: Systems programming language for core backend functionality.
• SQLite: Embedded database for local data storage.
• Diesel: Safe, extensible ORM and query builder for Rust.

• @wealthvn/addon-sdk: TypeScript SDK for addon development with full type safety.
• @wealthvn/addon-dev-tools: CLI tools and development server for hot reload.
• @wealthvn/ui: Shared UI component library for consistent styling.

wealthvn/
├── src/                         # Main source code for the React application
│   ├── addons/                  # Addon system core functionality
│   ├── components/              # React components
│   ├── pages/                   # Application pages and routes
│   ├── hooks/                   # Custom React hooks
│   └── lib/                     # Utility libraries and helpers
├── src-core/                    # Core backend functionality (Rust)
├── src-tauri/                   # Tauri-specific code for desktop app functionality
├── src-server/                  # Web server (Axum)
├── addons/                      # Example and sample addons
├── packages/                    # Shared packages and tools
│   ├── addon-sdk/               # Addon SDK for developers
│   ├── addon-dev-tools/         # Development tools and CLI
│   └── ui/                      # Shared UI components library
├── docs/                        # Documentation
└── public/                      # Public assets

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Make your changes.
4. Commit your changes (git commit -m 'Add some feature').
5. Push to the branch (git push origin feature-branch).
6. Open a pull request.

This project is licensed under the AGPL-3.0 license. See the LICENSE file for details.

• Original project: Wealthfolio by Aziz Fadil
• WealthVN fork by: Chipheo00 - CFPM Inc. WealthVN Team

Enjoy managing your wealth with WealthVN!