How misterpea/s3-ui works
Project type and purpose
• This is a full-stack web application (“S3 UI”) providing a user interface for AWS S3 (or a localstack emulator).
• Frontend: React/Redux SPA, SCSS styling, drag-and-drop file uploads.
• Backend: Node/Express proxy layer handling RESTful routes and AWS SDK V3 calls to S3.
• Deployable via Docker-Compose with Nginx reverse proxy, or runnable locally via Webpack dev server and localstack.
File structure
• Top level:
• backend/ – Express server, routes.js, S3 helper modules, Dockerfile, .env for S3 credentials and mode.
• frontend/ – React app, components, Redux store (actions, reducers, middleware), SCSS, Webpack config, Dockerfile, nginx.conf.
• docker-compose.yml – orchestrates frontend, backend, localstack, nginx containers.
• nginx/ – custom Nginx config for production.
• shell scripts/ – helpers to clone real S3 into localstack.
• Notice separation of concerns: UI layer (React + Nginx), API layer (Express), Storage layer (AWS S3 or localstack).
README for additional insights
• Modes:
• dev: Webpack dev server + localstack CLI (pip/local).
• prod: Docker-Compose, services defined in yml.
• Supported operations: bucket CRUD, folder CRUD, file upload/download/delete, progress tracking, query-string navigation.
• Long-term dev: file previews, email links, nested folder uploads.
• Stack: React, Redux, Axios, Express, @aws-sdk/client-s3, Docker, Nginx, Jest/Enzyme, GCP Compute Engine, localstack.
Detail
• In frontend, highlight Redux layers: UI components → actions → middleware → reducers → store.
• Example user flows: bucket creation, file upload (drag-drop), folder navigation via query strings.
• Docker-Compose networking: show the overlay network linking containers by service name.