feat: Add VitePress docs, EPUB to PDF tool, Phosphor icons, and licensing updates

- Set up VitePress documentation site (docs:dev, docs:build, docs:preview) - Added Getting Started, Tools Reference, Contributing, and Commercial License pages - Created self-hosting guides for Docker, Vercel, Netlify, Cloudflare, AWS, Hostinger, Nginx, Apache - Updated README with documentation link, sponsors section, and docs contribution guide - Added EPUB to PDF converter using LibreOffice WASM - Migrated to Phosphor Icons for consistent iconography - Added donation ribbon banner on landing page - Removed 'Like My Work?' section (replaced by ribbon) - Updated licensing.html with delivery model, AGPL notice, invoicing, and no-refund policy - Added Commercial License documentation page - Updated translations table (Chinese added, marked non-English as In Progress) - Added sponsors.yml workflow for auto-generating sponsor avatars
2025-12-27 19:30:31 +05:30
parent 0e888743d3
commit f30a084fce
189 changed files with 59872 additions and 3300 deletions
--- a/docs/self-hosting/aws.md
+++ b/docs/self-hosting/aws.md
@@ -0,0 +1,132 @@
+# Deploy to AWS S3 + CloudFront
+
+Host BentoPDF on AWS for maximum control and scalability.
+
+## Architecture
+
+```
+User → CloudFront (CDN) → S3 (Static Files)
+```
+
+## Step 1: Create S3 Bucket
+
+```bash
+# Create bucket
+aws s3 mb s3://your-bentopdf-bucket --region us-east-1
+
+# Enable static website hosting
+aws s3 website s3://your-bentopdf-bucket \
+  --index-document index.html \
+  --error-document index.html
+```
+
+## Step 2: Build and Upload
+
+```bash
+# Build the project
+npm run build
+
+# Sync to S3
+aws s3 sync dist/ s3://your-bentopdf-bucket \
+  --delete \
+  --cache-control "max-age=31536000"
+
+# Set correct MIME types for WASM
+aws s3 cp s3://your-bentopdf-bucket/ s3://your-bentopdf-bucket/ \
+  --recursive \
+  --exclude "*" \
+  --include "*.wasm" \
+  --content-type "application/wasm" \
+  --metadata-directive REPLACE
+```
+
+## Step 3: Create CloudFront Distribution
+
+```bash
+aws cloudfront create-distribution \
+  --origin-domain-name your-bentopdf-bucket.s3.amazonaws.com \
+  --default-root-object index.html
+```
+
+Or use the AWS Console:
+
+1. Go to CloudFront → Create distribution
+2. Origin domain: Select your S3 bucket
+3. Enable "Origin Access Control"
+4. Default root object: `index.html`
+5. Create distribution
+
+## Step 4: S3 Bucket Policy
+
+Allow CloudFront to access the bucket:
+
+```json
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Sid": "AllowCloudFrontAccess",
+      "Effect": "Allow",
+      "Principal": {
+        "Service": "cloudfront.amazonaws.com"
+      },
+      "Action": "s3:GetObject",
+      "Resource": "arn:aws:s3:::your-bentopdf-bucket/*",
+      "Condition": {
+        "StringEquals": {
+          "AWS:SourceArn": "arn:aws:cloudfront::ACCOUNT_ID:distribution/DISTRIBUTION_ID"
+        }
+      }
+    }
+  ]
+}
+```
+
+## Step 5: Custom Error Pages
+
+Configure 404 to return `index.html` for SPA routing:
+
+1. CloudFront → Error pages
+2. Create custom error response:
+   - HTTP error code: 404
+   - Response page path: `/index.html`
+   - HTTP response code: 200
+
+## Cost Estimation
+
+| Resource | Estimated Cost |
+|----------|----------------|
+| S3 Storage (~500MB) | ~$0.01/month |
+| CloudFront (1TB transfer) | ~$85/month |
+| CloudFront (10GB transfer) | ~$0.85/month |
+
+::: tip
+Use S3 Intelligent Tiering for cost optimization on infrequently accessed files.
+:::
+
+## Automation with Terraform
+
+```hcl
+# main.tf
+resource "aws_s3_bucket" "bentopdf" {
+  bucket = "your-bentopdf-bucket"
+}
+
+resource "aws_cloudfront_distribution" "bentopdf" {
+  origin {
+    domain_name = aws_s3_bucket.bentopdf.bucket_regional_domain_name
+    origin_id   = "S3Origin"
+  }
+  
+  enabled             = true
+  default_root_object = "index.html"
+  
+  default_cache_behavior {
+    allowed_methods  = ["GET", "HEAD"]
+    cached_methods   = ["GET", "HEAD"]
+    target_origin_id = "S3Origin"
+    
+    viewer_protocol_policy = "redirect-to-https"
+  }
+}
+```