add: huggingface docker

Dockerfile.hf

@@ -0,0 +1,44 @@
+# Stage 1: Build stage
+FROM node:18-alpine AS builder
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies
+RUN npm ci --only=production=false
+
+# Copy source code
+COPY . .
+
+# Build the application
+RUN npm run build
+
+# Stage 2: Production stage for Hugging Face Spaces
+FROM nginx:alpine AS production
+
+# Install wget for healthcheck
+RUN apk add --no-cache wget
+
+# Copy built application from builder stage
+COPY --from=builder /app/dist /usr/share/nginx/html
+
+# Copy custom nginx configuration for HF Spaces
+COPY nginx.hf.conf /etc/nginx/nginx.conf
+
+# Create nginx directories with proper permissions
+RUN mkdir -p /var/cache/nginx/client_temp \
+    /var/cache/nginx/proxy_temp \
+    /var/cache/nginx/fastcgi_temp \
+    /var/cache/nginx/uwsgi_temp \
+    /var/cache/nginx/scgi_temp && \
+    chown -R nginx:nginx /var/cache/nginx && \
+    chmod -R 755 /var/cache/nginx
+
+# Expose port 7860 (required by Hugging Face Spaces)
+EXPOSE 7860
+
+# Start nginx on port 7860
+CMD ["nginx", "-g", "daemon off;"]

README-HF.md

@@ -0,0 +1,178 @@
+# Hugging Face Spaces Deployment Guide
+
+This guide explains how to deploy your Invoice Generator application to Hugging Face Spaces.
+
+## Prerequisites
+
+- Hugging Face account
+- Git installed locally
+- Application built and tested locally
+
+## Quick Start
+
+### 1. Test Locally with HF Configuration
+
+First, test your application with the Hugging Face Spaces configuration:
+
+```bash
+# Make the deployment script executable
+chmod +x deploy-hf.sh
+
+# Deploy locally using HF configuration
+./deploy-hf.sh
+```
+
+Your app will be available at `http://localhost:7860`
+
+### 2. Create a New Space on Hugging Face
+
+1. Go to https://huggingface.co/new-space
+2. Choose a name for your space
+3. Set the **SDK** to `Docker`
+4. Set visibility (Public/Private)
+5. Click "Create Space"
+
+### 3. Prepare Files for Upload
+
+You need to upload these files to your Hugging Face Space:
+
+**Required Files:**
+- `Dockerfile` (rename `Dockerfile.hf` to `Dockerfile`)
+- `nginx.hf.conf`
+- `package.json`
+- `package-lock.json`
+- `index.html`
+- `script.js`
+- `style.css`
+- `.dockerignore`
+
+**Optional Files:**
+- `README.md` (Space description)
+- Any other assets your app needs
+
+### 4. Upload to Hugging Face Spaces
+
+#### Option A: Web Interface
+1. Go to your newly created Space
+2. Click "Files" tab
+3. Upload all required files
+4. Rename `Dockerfile.hf` to `Dockerfile`
+
+#### Option B: Git (Recommended)
+```bash
+# Clone your space repository
+git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
+cd YOUR_SPACE_NAME
+
+# Copy required files
+cp ../path/to/your/project/Dockerfile.hf ./Dockerfile
+cp ../path/to/your/project/nginx.hf.conf ./
+cp ../path/to/your/project/package*.json ./
+cp ../path/to/your/project/index.html ./
+cp ../path/to/your/project/script.js ./
+cp ../path/to/your/project/style.css ./
+cp ../path/to/your/project/.dockerignore ./
+
+# Commit and push
+git add .
+git commit -m "Initial deployment of Invoice Generator"
+git push
+```
+
+### 5. Configure Space Settings
+
+In your Space settings, ensure:
+- **SDK**: Docker
+- **Port**: 7860 (automatically detected)
+- **Hardware**: CPU Basic (or upgrade if needed)
+
+## File Structure for Hugging Face Spaces
+
+```
+your-space/
+├── Dockerfile              # Renamed from Dockerfile.hf
+├── nginx.hf.conf           # Nginx config for port 7860
+├── package.json            # Node.js dependencies
+├── package-lock.json       # Locked versions
+├── index.html              # Main HTML file
+├── script.js               # JavaScript code
+├── style.css               # Styles
+├── .dockerignore           # Docker ignore rules
+└── README.md               # Space description (optional)
+```
+
+## Key Differences from Standard Deployment
+
+### Port Configuration
+- **Standard**: Port 80/8080
+- **Hugging Face Spaces**: Port 7860 (required)
+
+### Dockerfile Changes
+- Uses `Dockerfile.hf` which configures nginx for port 7860
+- Includes `wget` for health checks
+- Exposes port 7860
+
+### Nginx Configuration
+- `nginx.hf.conf` listens on port 7860
+- Includes health check endpoint at `/health`
+- Optimized for Hugging Face Spaces environment
+
+## Troubleshooting
+
+### Build Failures
+1. Check that all required files are uploaded
+2. Verify `package.json` has all dependencies
+3. Check Dockerfile syntax
+
+### Runtime Issues
+1. Check Space logs in the Hugging Face interface
+2. Ensure port 7860 is properly configured
+3. Verify nginx configuration
+
+### Common Issues
+
+**Issue**: Space shows "Building" for too long
+**Solution**: Check for missing dependencies in package.json
+
+**Issue**: Application not accessible
+**Solution**: Verify nginx is listening on port 7860, not 80
+
+**Issue**: Static files not loading
+**Solution**: Check file paths and nginx static file configuration
+
+## Health Check
+
+Your deployed Space will have a health check endpoint at:
+```
+https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/health
+```
+
+## Production Considerations
+
+### Performance
+- Consider upgrading to CPU/GPU hardware if needed
+- Monitor Space usage and logs
+- Optimize bundle size for faster builds
+
+### Security
+- Review Content Security Policy headers
+- Ensure no sensitive data in client-side code
+- Use HTTPS (automatically provided by HF Spaces)
+
+### Monitoring
+- Check Space analytics in Hugging Face dashboard
+- Monitor build times and resource usage
+- Set up alerts for Space downtime
+
+## Support
+
+- Hugging Face Spaces Documentation: https://huggingface.co/docs/hub/spaces
+- Community Forum: https://discuss.huggingface.co/
+- Discord: https://discord.gg/hugging-face
+
+## Next Steps
+
+1. Test your Space thoroughly after deployment
+2. Update README.md with Space-specific information
+3. Share your Space with the community
+4. Consider adding a demo or usage instructions

deploy-hf.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+
+# Build and deploy script for invoice generator on Hugging Face Spaces
+
+set -e
+
+echo "🤗 Starting Hugging Face Spaces deployment process..."
+
+# Stop existing services
+echo "🛑 Stopping existing services..."
+docker-compose -f docker-compose.hf.yml down 2>/dev/null || true
+
+# Build and start the Hugging Face Spaces service
+echo "📦 Building and starting services for HF Spaces..."
+docker-compose -f docker-compose.hf.yml up --build -d
+
+# Show status
+echo "📊 Service status:"
+docker-compose -f docker-compose.hf.yml ps
+
+echo "✅ Hugging Face Spaces deployment completed successfully!"
+echo "🌐 Application is available at: http://localhost:7860"
+echo "🤗 Ready to deploy to Hugging Face Spaces!"
+
+# Optional: Show logs
+echo "📋 Recent logs:"
+docker-compose -f docker-compose.hf.yml logs --tail=20 invoice-generator
+
+echo ""
+echo "📝 Next steps for Hugging Face Spaces:"
+echo "1. Create a new Space on Hugging Face"
+echo "2. Upload these files to your Space:"
+echo "   - Dockerfile.hf (rename to Dockerfile)"
+echo "   - nginx.hf.conf"
+echo "   - All your source files (package.json, src/, etc.)"
+echo "3. Set Space SDK to 'docker'"
+echo "4. Your app will be available on port 7860"

docker-compose.hf.yml

@@ -0,0 +1,44 @@
+services:
+  invoice-generator:
+    build:
+      context: .
+      dockerfile: Dockerfile.hf
+      target: production
+    ports:
+      - "7860:7860"
+    restart: unless-stopped
+    container_name: invoice-generator-hf
+    environment:
+      - NODE_ENV=production
+      - PORT=7860
+    labels:
+      - "com.docker.compose.service=invoice-generator"
+      - "com.docker.compose.environment=huggingface"
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:7860/"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    deploy:
+      resources:
+        limits:
+          memory: 512M
+          cpus: "0.5"
+        reservations:
+          memory: 256M
+          cpus: "0.25"
+    security_opt:
+      - no-new-privileges:true
+    read_only: true
+    tmpfs:
+      - /tmp
+      - /var/cache/nginx
+      - /var/run
+      - /run
+      - /var/log/nginx

nginx.hf.conf

@@ -0,0 +1,64 @@
+events {
+    worker_connections 1024;
+}
+
+http {
+    include /etc/nginx/mime.types;
+    default_type application/octet-stream;
+
+    # Logging
+    access_log /var/log/nginx/access.log;
+    error_log /var/log/nginx/error.log;
+
+    # Gzip compression
+    gzip on;
+    gzip_vary on;
+    gzip_min_length 1024;
+    gzip_proxied any;
+    gzip_comp_level 6;
+    gzip_types
+        text/plain
+        text/css
+        text/xml
+        text/javascript
+        application/javascript
+        application/xml+rss
+        application/json;
+
+    # Security headers
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header X-XSS-Protection "1; mode=block" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header Referrer-Policy "no-referrer-when-downgrade" always;
+    add_header Content-Security-Policy "default-src 'self' http: https: data: blob: 'unsafe-inline'" always;
+
+    server {
+        listen 7860;
+        server_name _;
+        root /usr/share/nginx/html;
+        index index.html;
+
+        # Cache static assets
+        location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
+            expires 1y;
+            add_header Cache-Control "public, immutable";
+        }
+
+        # Handle SPA routing
+        location / {
+            try_files $uri $uri/ /index.html;
+        }
+
+        # Health check endpoint for HF Spaces
+        location /health {
+            access_log off;
+            return 200 "healthy\n";
+            add_header Content-Type text/plain;
+        }
+
+        # Security
+        location ~ /\. {
+            deny all;
+        }
+    }
+}