Skip to content

kuosc2005/certifly

Repository files navigation

Certifly - Web-based Certificate Generation Tool

Certifly is an open-source web-based certificate generation tool written in Svelte by Kathmandu university Open Source Commmunity (KUOSC). It simplifies the process of creating certificates by allowing users to provide a template image and a CSV file containing recipient information.

Table of Contents

Features

  • Easy Certificate Generation: Generate customized certificates by providing a template image and recipient data in CSV format.

  • Supports Various Formats: Certifly supports PNG and JPEG/JPG image formats for templates and CSV data.

  • Bulk Export: Export generated certificates in bulk as a zip file.

Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

Installation

  1. Clone the Certifly repository to your local machine:

    git clone [email protected]:kuosc2005/certifly.git
    cd certifly
  2. Install the project dependencies:

    pnpm install

Usage

  1. Prepare your template image:

    Prepare certificate template image in PNG or JPEG/JPG format.

  2. Prepare your CSV data file:

    Create a CSV file (e.g., recipients.csv). For example:

    name,email,course,date
    John Doe,[email protected],Introduction to Certificates,2023-09-17
    Jane Smith,[email protected],Advanced Certificates,2023-09-18
    
  3. Start the Certifly application

    pnpm dev
  4. Use the website:

  • Open your web browser and navigate to the Certifly application (typically at http://localhost:5173 during development).

  • Use the website to upload your template image and CSV data files.

  • Click on the template image to define placeholder

  • Make sure to specify the placeholder's value in the template that match the columns in your CSV file.

  • After uploading the necessary files and specifying placeholder, click the "Generate" button.

  • Download the certificates by clicking on "Download" button.

Contributing to Certifly

Please go through CONTRIBUTING.md

License

Certifly is licensed under the MIT License. Feel free to use, modify, and distribute it in your projects.

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •