Archived (2026-09-26). This frontend now lives in the private monorepo cmosgh/pdfthumb under apps/web, with this repository's full history. Issue references in the imported history point back here as cmosgh/pdfthumb.com#N. Open issues were transferred (#89 → cmosgh/pdfthumb#417, #176 → cmosgh/pdfthumb#418).

PDFThumb.com - PDF Thumbnail API

This repository contains the source code for PDFThumb.com, a web application for a PDF Thumbnail API service. It provides a simple and efficient way to generate thumbnails from your PDF documents.

Features

• Lightning Fast Generation: Our API processes PDFs and returns thumbnails in milliseconds.
• Scalable Infrastructure: Built to handle millions of requests, our infrastructure scales with your needs.
• Easy Integration: Simple REST API with clear documentation and client libraries for popular languages.
• Privacy First: Your PDF files are processed in memory and never stored on our servers.
• AI-Powered Integration (Coming Soon): We're enabling AI agents to intelligently interact with our API.
• Reliable Platform: We ensure high uptime and secure processing.
• Developer Friendly: Clear documentation, fair pricing, and responsive support.
• High Quality Thumbnails: Generate crisp, clear thumbnails perfect for previews, galleries, and document management systems.

Technology Stack

• Frontend: React, TypeScript, Tailwind CSS
• Build Tool: Vite
• Routing: TanStack Router
• Testing: Playwright
• CI/CD: GitHub Actions

Getting Started

Prerequisites

• Node.js (v22 or higher)
• npm

Installation

1. Clone the repository:

   git clone https://github.com/cmosgh/pdfthumb.com.git

2. Install the dependencies:

   npm install

Running the Application

1. Start the development server:

   npm run dev

2. Open your browser and navigate to http://localhost:5173.

Building the Application

To build the application for production, run the following command:

npm run build

This will create a dist directory with the optimized and minified assets.

Theming

A deployment can pick its own colours, fonts and logo at runtime, without rebuilding the image. See docs/theming.md.

Testing

This project uses Playwright for end-to-end testing. To run the tests, use either of the following commands:

npm test
# or
npx playwright test

Contributing

Contributions are welcome! Please follow the existing code style and conventions. All commit messages must follow the Conventional Commits specification.

License

This project is licensed under the MIT License. See the LICENSE file for details.