# nexus-geometry

**Repository Path**: newaylau/nexus-geometry

## Basic Information

- **Project Name**: nexus-geometry
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nexus Geometry

3D 几何实验室 - 一个交互式的 3D 几何折叠演示应用

## 项目介绍

Nexus Geometry 是一个基于 React + TypeScript + Vite 构建的交互式 3D 几何演示应用，主要功能是展示几何体的折叠与展开过程。用户可以通过直观的界面操作，体验不同几何图形的动态折叠效果。

## 技术栈

- **前端框架**: React
- **语言**: TypeScript
- **构建工具**: Vite
- **国际化**: i18n (支持中文、英文)
- **样式**: CSS3 with CSS Variables

## 功能特性

### 🧩 3D 几何折叠
- 交互式 3D 形状展示
- 支持折叠/展开动画效果
- 可旋转视角查看
- 点击单个面进行交互

### 🎨 多主题支持
- 青金石色 (teal-gold)
- 星空领域 (starry-field)
- 秋日阳光 (autumn-sun)
- 紫色星辰 (purple-star)
-  peach-breeze (桃色微风)
- 梦幻奇境 (dream-wonder)

### 🌍 国际化
- 支持中文 (简体中文)
- 支持英文 (English)
- 语言切换模态框

### 📱 响应式设计
- 适配多种屏幕尺寸
- 浅色/深色模式切换

## 快速开始

### 安装依赖

```bash
cd 3d-geometry-lab
npm install
```

### 启动开发服务器

```bash
npm run dev
```

### 构建生产版本

```bash
npm run build
```

## 项目结构

```
3d-geometry-lab/
├── src/
│   ├── components/
│   │   ├── Shape3D.tsx        # 3D 几何体组件
│   │   └── LanguageModal.tsx  # 语言选择模态框
│   ├── i18n/
│   │   ├── locales/
│   │   │   ├── en.json        # 英文翻译
│   │   │   └── zh.json        # 中文翻译
│   │   └── index.ts          # i18n 配置
│   ├── App.tsx               # 主应用组件
│   ├── App.css               # 应用样式
│   ├── index.css             # 全局样式
│   ├── themes.ts             # 主题配置
│   └── main.tsx              # 入口文件
├── index.html
├── package.json
└── vite.config.ts
```

## 使用说明

1. **选择形状**: 在应用中可以选择不同的几何形状类型
2. **折叠操作**: 点击面或使用按钮控制几何体的折叠状态
3. **旋转视图**: 启用旋转功能查看 3D 效果
4. **切换主题**: 通过设置菜单选择喜欢的主题配色
5. **切换语言**: 通过语言模态框切换界面语言

## 许可证

MIT License