BoxGenerator/README.md

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 to your Gemini API key
3. Run the app: npm run dev

💾 Экспорт и Шеринг

• STL Экспорт: Генерация готовых к печати STL файлов. Можно скачать отдельные детали или весь проект архивом (ZIP).
• Сохранение проектов: Возможность поделиться ссылкой на конфигурацию (все параметры кодируются в URL).

🚀 Запуск Локально

Для работы требуется установленный Node.js.

1. Клонируйте репозиторий:

   git clone https://github.com/your-username/printfit-box-generator.git
   cd printfit-box-generator
   

2. Установите зависимости:

   npm install
   

3. Запустите локальный сервер разработки:

   npm run dev
   

4. Откройте приложение в браузере (обычно http://localhost:5173).

🐳 Запуск в Docker

Приложение можно легко развернуть в контейнере Docker (используется Nginx для раздачи статики).

1. Соберите образ:

   docker build -t printfit-app .
   

2. Запустите контейнер:

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