How kenezu17/cvtx works
ConvertX is a web file-conversion product: a user selects a file and target format, the frontend validates and submits it, the backend dispatches to a format-specific converter, and the user downloads the result. The README documents PDF/DOCX, image/PDF, CSV/XLSX, and Excel/PDF capabilities; the router also defines PDF/XLSX and PDF/image routes. Relationships are limited to calls or composition shown in excerpts and the source index; converter internals not excerpted are represented without speculative wiring.
Main entry points: convert.py Conversion endpoint · FileUpload.jsx Upload and convert · api.js API client · download.py Download endpoint
Components 22
Frontend experience
- React app entry
ConvertX/src/main.jsx - Home screen
ConvertX/src/page/Home.jsx - Upload and convert
ConvertX/src/components/upload/FileUpload.jsx - File preview
ConvertX/src/components/upload/FilePreview.jsx - Format options
ConvertX/src/components/converter/ConvertOptionBtn.jsx - Progress display
ConvertX/src/components/upload/ProgressBar.jsx - Download control
ConvertX/src/components/converter/DownloadBtn.jsx - Download client
ConvertX/src/utils/DownloadFile.js - API client
ConvertX/src/services/api.js
Conversion API
- FastAPI application
backend/app/main.py - Conversion endpoint
backend/app/routers/convert.py - Download endpoint
backend/app/routers/download.py - API key check
backend/app/dependencies.py
Conversion engines
- PDF conversions
backend/app/services/pdf_convert.py - DOCX conversion
backend/app/services/docs_convert.py - Image conversion
backend/app/services/image_convert.py - Excel conversion
backend/app/services/execel.py - CSV conversion
backend/app/services/csv.py - Image ZIP packaging
backend/app/utils/zip_utils.py
Temporary file handling
- Upload and output files
backend/app/routers/convert.py - Automatic cleanup
backend/app/services/cleanup.py
Other components
- File user
Connections 27
- File user → React app entry: opens interface
ConvertX/src/main.jsx - React app entry → Home screen: renders
- Home screen → Upload and convert: renders
ConvertX/src/page/Home.jsx - File user → Upload and convert: selects file
- Upload and convert → File preview: renders
ConvertX/src/components/upload/FileUpload.jsx - Upload and convert → Format options: renders
ConvertX/src/components/upload/FileUpload.jsx - Upload and convert → Progress display: renders
ConvertX/src/components/upload/FileUpload.jsx - Upload and convert → Download control: renders
ConvertX/src/components/upload/FileUpload.jsx - Upload and convert → API client: posts conversion
ConvertX/src/components/upload/FileUpload.jsx - Download control → Download client: invokes
ConvertX/src/components/converter/DownloadBtn.jsx - Download client → API client: requests file
ConvertX/src/utils/DownloadFile.js - API client → Conversion endpoint: sends conversion request
- API client → Download endpoint: requests download
- FastAPI application → Conversion endpoint: registers route
backend/app/main.py - FastAPI application → Download endpoint: registers route
backend/app/main.py - FastAPI application → Automatic cleanup: starts worker
backend/app/main.py - Conversion endpoint → API key check: checks API key
backend/app/routers/convert.py - Conversion endpoint → PDF conversions: dispatches PDF jobs
backend/app/routers/convert.py - Conversion endpoint → DOCX conversion: dispatches DOCX jobs
backend/app/routers/convert.py - Conversion endpoint → Image conversion: dispatches image jobs
backend/app/routers/convert.py - Conversion endpoint → Excel conversion: dispatches Excel jobs
backend/app/routers/convert.py - Conversion endpoint → CSV conversion: dispatches CSV jobs
backend/app/routers/convert.py - Conversion endpoint → Image ZIP packaging: packages image output
backend/app/routers/convert.py - Conversion endpoint → Upload and output files: writes conversion files
backend/app/routers/convert.py - Download endpoint → API key check: checks API key
backend/app/routers/download.py - Download endpoint → Upload and output files: reads output files
backend/app/routers/download.py - Automatic cleanup → Upload and output files: removes expired files