GithubHelp home page GithubHelp logo

howardshand / docking Goto Github PK

View Code? Open in Web Editor NEW

This project forked from shipsaas/docking

0.0 0.0 0.0 2.15 MB

DocKing: Your shared-microservice that takes over the document templates management & render/export PDF

Home Page: https://docking.shipsaas.tech

License: MIT License

Shell 0.32% JavaScript 4.54% PHP 59.80% CSS 3.40% HTML 1.96% Vue 27.20% Blade 1.83% Dockerfile 0.94%

docking's Introduction

DocKing from ShipSaaS

Introducing RenderPDF.io - Render your PDF in seconds

RenderPDF.io

RenderPDF.io is a Render-PDF-as-a-Service that provides developer-friendly APIs to render your HTML content to modern PDFs file sin seconds ๐Ÿ˜Ž.

All you have to do is get your API Key and send RenderPDF.io an API call ๐Ÿš€, no infrastructure setup, no overhead and hassle-free integration ๐Ÿ”‹.

Get your free API Key today: Sign Up to RenderPDF.io

Introducing DocKing

Build & Test (PHP 8.2) Integration Tests E2E Tests codecov

DocKing is a document management service/microservice that handles templates and renders them in PDF format, all in one place.

You can utilize DocKing as a shared microservice, which can be integrated & used in any services from your big product.

Documentation: DocKing

DocKing is well-tested & production-ready ๐Ÿ˜‰๐ŸŽ๏ธ๐Ÿš€

LIVE DEMO ๐Ÿ”ฅ

URL: https://docking-demo.shipsaas.tech/

Console: https://docking-demo.shipsaas.tech/console#/

  • Password: None
  • Drivers:
    • Gotenberg: Yes, use the Live Demo Instance (from Gotenberg.dev)
    • WkHtmlToPdf: Yes, without any extensions or fonts.
    • mPDF: Yes, without any extensions or fonts.
  • Most of the features are disabled. You can only view & preview PDFs in multiple drivers.

Features ๐Ÿš€

  • Manage all of your document templates just in one place ๐Ÿ“ฐ๐Ÿงพ.
  • Dynamically render & export PDF from your desired data ๐Ÿƒโ€.
  • Supports multiple state-of-the-art PDF Engines ๐Ÿป.
  • Supports sync & async PDF rendering modes ๐Ÿ”ฅ.
  • Webhook notification after PDF rendered (for async flow) ๐Ÿš€
  • Built-in UI-console to manage & review the templates & files (for internal use) ๐Ÿ”‹.
  • Horizontal scaling when traffic goes high? DocKing got that ๐Ÿ˜‰.

Check out our planned features here: The DocKing Project

Diagram of how it works

DocKing

From the diagram above, DocKing is standing as a "shared-microservice".

  • Billing Service can manage their bill templates and render the PDFs.
  • Order Service can manage their order templates and render the PDFs.
  • Contract Service can manage their contract templates and render the PDFs.
  • ...

Awesome, IKR?

The Awesome Console UI

DocKing ships the Built-in Console with awesome editor & features. Help you and the team to collaborate and manage everything easily.

DocKing's Console UI

Learn more: DocKing's Console UI

DocKing uses

  • PHP 8.2
  • Laravel 10
  • Any database (MySQL, PostgreSQL or SQLite - your choice)
    • Personal preference: MySQL 8
  • Vue 3
  • Tailwind CSS

PDF Rendering Services

  • Gotenberg โญ๏ธ
  • wkHTMLtoPDF โœ…
  • mPDF ๐Ÿงฐ (available since v1.1.0)

Tests

  • Unit Tests to cover all functions & methods โ‡๏ธ
  • Integration Tests to test against REAL PDF ENGINES:
    • Gotenberg โœ…
    • WkHtmlToPdf โœ…
    • mPDF โœ…
  • E2E Tests to validate REAL WORLD API CALLs & Rendering Async Flow

LICENSE

MIT LICENSE

Development & Contribution Guidelines

  • Please follow PSR-1 & PSR-12 coding conventions
  • Unit/Integration testing is a must

Thank you very much for your contributions!

Contributors

ShipSaaS x Seth Phat & Contributors.

Copyright

Copyright ยฉ๏ธ 2023 by ShipSaaS x Seth Phat.

docking's People

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.