Novault

Novault 是一款现代化的个人记账应用，旨在提供简洁、高效且美观的财务管理体验。项目基于 React Native 和 TypeScript 开发。

✨ 主要功能

• 多维账本: 支持资产（现金、银行卡、投资）和负债（信用卡、贷款）账户管理。
• 交易记录: 快速记录收入、支出和转账，支持分类、标签和备注。
• 预算控制: 灵活设置月度或自定义周期预算，实时监控消费进度。
• 隐私保护: 支持隐私模式，一键模糊敏感金额信息。
• 美观界面: 采用现代化设计语言，支持深色/浅色模式切换。

🛠️ 技术栈

• 核心框架: React Native, TypeScript
• 导航: React Navigation
• 状态管理: Context API + Hooks
• 网络请求: Fetch API (封装)
• 样式: StyleSheet, Vanilla CSS concepts

🚀 快速开始

环境依赖

• Node.js (>= 18)
• Yarn 或 npm
• Android Studio (用于 Android 开发)
• Xcode (用于 iOS 开发，仅限 macOS)
• 后端服务 (需单独部署，默认运行在 http://localhost:3000)

安装步骤

1. 克隆项目到本地：

   git clone <repository-url>
   cd app
   

2. 安装依赖：

   npm install
   # 或者
   yarn install
   

3. (iOS Only) 安装 Pods：

   cd ios
   pod install
   cd ..
   

运行应用

1. 启动 Metro 服务：

   npm start
   

2. 在 Android 上运行：

   npm run android
   

3. 在 iOS 上运行：

   npm run ios
   

📂 目录结构

src/
├── components/   # 可复用组件 (Common, Layouts)
├── contexts/     # 全局状态 Context (Theme, Auth, Privacy)
├── navigation/   # 路由导航配置
├── screens/      # 页面组件 (Accounts, Transactions, Budget, etc.)
├── services/     # API 服务封装
├── theme/        # 主题样式定义
├── types/        # TypeScript 类型定义
└── utils/        # 工具函数

🤝 贡献

欢迎提交 Issue 或 Pull Request 来改进项目。

📄 许可证

MIT