<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. Вы можете свободно использовать, изменять и распространять его.