73 lines
2.5 KiB
Markdown
73 lines
2.5 KiB
Markdown
<div align="center">
|
||
<img width="1200" height="475" alt="GHBanner" src="https://github.com/user-attachments/assets/0aa67016-6eaf-458a-adb2-6e31a0763ed6" />
|
||
</div>
|
||
|
||
# Run and deploy your AI Studio app
|
||
|
||
This contains everything you need to run your app locally.
|
||
|
||
View your app in AI Studio: https://ai.studio/apps/drive/1gUfO_tgl_CPfAGf1eXuSFyC0K7nUZFgu
|
||
|
||
## Run Locally
|
||
|
||
**Prerequisites:** Node.js
|
||
|
||
|
||
1. Install dependencies:
|
||
`npm install`
|
||
2. Set the `GEMINI_API_KEY` in [.env.local](.env.local) to your Gemini API key
|
||
3. Run the app:
|
||
`npm run dev`
|
||
|
||
### 💾 Экспорт и Шеринг
|
||
- **STL Экспорт**: Генерация готовых к печати STL файлов. Можно скачать отдельные детали или весь проект архивом (ZIP).
|
||
- **Сохранение проектов**: Возможность поделиться ссылкой на конфигурацию (все параметры кодируются в URL).
|
||
|
||
## 🚀 Запуск Локально
|
||
|
||
Для работы требуется установленный **Node.js**.
|
||
|
||
1. Клонируйте репозиторий:
|
||
```bash
|
||
git clone https://github.com/your-username/printfit-box-generator.git
|
||
cd printfit-box-generator
|
||
```
|
||
|
||
2. Установите зависимости:
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
3. Запустите локальный сервер разработки:
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
4. Откройте приложение в браузере (обычно http://localhost:5173).
|
||
|
||
## 🐳 Запуск в Docker
|
||
|
||
Приложение можно легко развернуть в контейнере Docker (используется Nginx для раздачи статики).
|
||
|
||
1. Соберите образ:
|
||
```bash
|
||
docker build -t printfit-app .
|
||
```
|
||
|
||
2. Запустите контейнер:
|
||
```bash
|
||
docker run -p 8080:80 printfit-app
|
||
```
|
||
|
||
3. Откройте http://localhost:8080
|
||
|
||
## 🛠 Технологический Стек
|
||
- **React**: UI и управление состоянием.
|
||
- **Three.js (@react-three/fiber)**: 3D рендеринг и геометрия.
|
||
- **Tailwind CSS**: Стилизация интерфейса.
|
||
- **Vite**: Сборщик проекта.
|
||
- **Lucide React**: Иконки.
|
||
|
||
## 📝 Лицензия
|
||
Этот проект распространяется под лицензией MIT. Вы можете свободно использовать, изменять и распространять его.
|