Awesome
<p align="center"> <img src="https://raw.githubusercontent.com/techprimate/tppdf/main/resources/header.png" alt="TPPDF"> </p> <p align="center"> <b> TPPDF is a fast PDF builder for iOS & macOS using simple commands to create advanced documents! </b> </p> <div align="center"> <a href="https://swiftpackageindex.com/techprimate/TPPDF"> <img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Ftechprimate%2FTPPDF%2Fbadge%3Ftype%3Dswift-versions" alt="Supported Swift Versions"> </a> <a href="https://swiftpackageindex.com/techprimate/TPPDF"> <img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Ftechprimate%2FTPPDF%2Fbadge%3Ftype%3Dplatforms" alt="Supported Platforms"> </a> <img src="https://img.shields.io/badge/license-MIT-lightgrey.svg?style=flat-square" alt="License"/> </div> <div align="center"> <img src="https://img.shields.io/badge/SPM-compatible-brightgreen.svg?style=flat-square" alt="Swift Package Manager"/> <img src="https://img.shields.io/cocoapods/v/TPPDF.svg?style=flat-square" alt="Cocoapods"/> <img src="https://img.shields.io/badge/Carthage-compatible-blue.svg?style=flat-square" alt="Carthage"/> </div> <p align="center"> <sub>Created and maintained by <a href="https://github.com/philprime">Philip Niedertscheider</a> and all the amazing <a href="https://github.com/techprimate/TPPDF/graphs/contributors">contributors</a>.</sub> </p> <p align="center"> <a href="#features">Features</a> • <a href="#getting-started">Getting Started</a> • <a href="#communication">Communication</a> • <a href="https://github.com/techprimate/TPPDF/blob/main/Documentation/Usage.md"><strong>Usage</strong></a> • <a href="https://github.com/techprimate/TPPDF/blob/main/Documentation/Installation.md">Installation</a> • <a href="#credits">Credits</a> • <a href="https://github.com/techprimate/TPPDF/blob/master/LICENSE">License</a> </p>Features
- Page header and footer
- Dynamic content layout with page alignment
- Support for tables and cell alignment
- Attributed strings
- Custom spacing
- Image support
- Horizontal line separators
- Custom indentation
- Custom top offset (good for layered rendering)
- Pagination
- Image caption
- Compress images
- Custom image size fit
- Images in the header and footer
- Horizontal line separators in the header and footer
- Generate PDF files directly to handle large PDF files (Details)
- PDF metadata
- Custom table styling
- Multi-column sections
- Swift Package Manager Support
- Tables with cell merging & automatic page breaking
- Hyperlinks in text
- Native progress tracking using
Foundation.Progress
Getting Started
Building a PDF document is very easy:
First, you create a document with a paperformat...
let document = PDFDocument(format: .a4)
...then you add your information to a container...
document.add(.contentCenter, text: "Create PDF documents easily.")
...then you render the document...
let generator = PDFGenerator(document: document)
let url = try generator.generateURL(filename: "Example.pdf")
...done!
If you need more details, checkout Usage.
Communication
Attention:
TPPDF is an Open Source side-project of techprimate. As we are currently working on multiple other projects, we only have limited time for fixing bugs and enhancing TPPDF.
That's why any issue reporting and especially Pull Requests are very welcome!
If you need professional support for your company, you can reach out to @philprimes on Twitter or on our website techprimate.com! This is mainly for custom or high-priority requests, therefore we won't publish a consulting pricing for now.
For everything else, please see Communication and this message. Thank you!
- If you need help, open an issue.
- If you found a bug, open an issue.
- If you have a feature request, open an issue.
- If you want to contribute, submit a pull request.
Example
Take a look at the Getting Started Guide or checkout the Examples (using of one of the following):
- Clone the repository and open the
Examples.xcworkspace
- Run the
Example macOS (SPM)
orExample macOS (iOS)
Apps using TPPDF
If you are using TPPDF in your app and want to be listed here, simply create a pull request or let us know on Twitter or via GitHub. We are always curious to see, who is using our project :)
<table> <tr> <td align="center"> <a href="https://itunes.apple.com/app/id1495886665"> <img src="https://raw.githubusercontent.com/techprimate/TPPDF/main/resources/apps/BurnoutCoach.png" alt="Burnout Coach"/> </a> </td> <td align="center"> <a href="https://itunes.apple.com/app/id1464880768"> <img src="https://raw.githubusercontent.com/techprimate/TPPDF/main/resources/apps/ChatHistory.png" alt="ChatHistory"/> </a> </td> <td align="center"> <a href="https://itunes.apple.com/app/id1464880768"> <img src="https://raw.githubusercontent.com/techprimate/tppdf/main/resources/apps/Hikingbook.png" alt="Hikingbook"/> </a> </td> <td align="center"> <a href="https://itunes.apple.com/us/app/bug-journal/id1232077952"> <img src="https://raw.githubusercontent.com/techprimate/tppdf/main/resources/apps/Bug_Journal.png" alt="Bug Journal"/> </a> </td> <td align="center"> <a href="https://itunes.apple.com/de/app/energy-tracker/id1193010972"> <img src="https://raw.githubusercontent.com/techprimate/tppdf/main/resources/apps/EnergyTracker.jpg" alt="EnergyTracker"/> </a> </td> <td align="center"> <a href="https://apps.apple.com/us/app/lyrcs/id1599888045"> <img src="https://raw.githubusercontent.com/techprimate/tppdf/main/resources/apps/Lyrcs.svg" alt="Lyrcs" height=120 /> </a> </td> </tr> <tr> <td align="center"> <a href="https://itunes.apple.com/app/id1464880768">Burnout Coach</strong></a><br> by Stéphane Mégy </td> <td align="center"> <a href="https://itunes.apple.com/app/id1464880768">ChatHistory</a><br> by techprimate </td> <td align="center"> <a href="https://itunes.apple.com/app/id1067838748">Hikingbook</a><br> by Zheng-Xiang Ke </td> <td align="center"> <a href="https://itunes.apple.com/us/app/bug-journal/id1232077952">Bug Journal</a><br> by David Johnson </td> <td align="center"> <a href="https://itunes.apple.com/de/app/energy-tracker/id1193010972">EnergyTracker</a><br> by Stefan Nebel </td> <td align="center"> <a href="https://apps.apple.com/us/app/lyrcs/id1599888045">Lyrcs</a><br> by ptrkstr </td> </tr> </table>Credits
TPPDF is created and maintained by Philip Niedertscheider, co-founder of techprimate.
<p align="center"> <a href="https://www.techprimate.com"> <img src="https://img.shields.io/badge/www-techprimate.com-lightgrey.svg?style=flat-square" alt="techprimate.com"> </a> <a href="http://twitter.com/techprimate"> <img src="https://img.shields.io/badge/twitter-@techprimate-blue.svg?style=flat-square" alt="twitter"> </a> </p>Contributors
Please consider backing this project by using the following GitHub Sponsor button.
We want to thank all contributors for their effort!
<a href="https://github.com/techprimate/TPPDF/graphs/contributors"> <img src="https://contributors-img.web.app/image?repo=techprimate/TPPDF" /> </a>