pratham1uk/letsnscrape-frontend repository overview

⁠LetsNScrape — Frontend UI | v1.0.0

React web interface for LetsNScrape served via Nginx on port 3071. Part of the NScrape series.

Provides a dark-themed UI to submit scrape jobs, configure filters and engines, watch live progress, browse all extracted data, and download results as PDF or DOCX — no API knowledge needed.

---

⁠What this image does

• Serves the compiled React 18 app via Nginx on port 3071
• Proxies all /api/* calls to the backend container (no CORS setup needed)
• Filter controls: Everything / Text / Images / Links / Metadata / Headings / Tables
• Engine selector: Auto-detect / Scrapy HTTP / Playwright
• Advanced options: max pages, crawl depth, follow links, same-domain only
• Live progress bar while scraping
• Collapsible per-page results with image previews, link lists, metadata grids
• One-click PDF and DOCX download

---

⁠Prerequisites

• Docker Engine 20.10+
• Backend and Redis containers must be running first

---

⁠⚠️ Mandatory companion containers

This image only serves the UI — all scraping is done by the backend. You must have all three running:

1. redis:7.2-alpine — job store (required)
2. pratham1uk/letsnscape-backend:v1.0.0 — scraping API (required)
3. pratham1uk/letsnscape-frontend:v1.0.0 — this image

Without the backend, the UI loads but all scrape requests will fail.

---

⁠Quick start

docker network create letsnscape-net

⁠Redis

docker run -d --name letsnscape-redis --network letsnscape-net
redis:7.2-alpine redis-server --port 6380

⁠Backend

docker run -d --name letsnscape-backend --network letsnscape-net
-p 3070:3070 -e REDIS_HOST=letsnscape-redis -e REDIS_PORT=6380
pratham1uk/letsnscape-backend:v1.0.0

⁠Frontend

docker run -d --name letsnscape-frontend --network letsnscape-net
-p 3071:3071
pratham1uk/letsnscape-frontend:v1.0.0

Open: http://localhost:3071⁠

---

⁠Recommended: Docker Compose

Download the compose file and env template — no source code needed:

curl -O https://raw.githubusercontent.com/pratham1uk/letsnscape-public/main/docker-compose.prod.yml⁠ curl -O https://raw.githubusercontent.com/pratham1uk/letsnscape-public/main/.env.example⁠ cp .env.example .env

⁠Change ports in .env if needed:

⁠FRONTEND_PORT=8080

⁠BACKEND_PORT=8000

⁠REDIS_PORT_HOST=6399

docker-compose -f docker-compose.prod.yml up -d

---

⁠Port

3071 — Nginx (map to any host port: -p 8080:3071)

The Nginx config inside this image proxies /api/* to http://backend:3070⁠ so both containers must share the same Docker network.

---

⁠Stack

React 18 | Vite 4 | Nginx 1.25 | Axios | Lucide React

Part of the NScrape series by pratham1uk.