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
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Contributing
• License

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:

• Node.js
• pnpm (Performant NPM)

Installation

1. Clone the Certifly repository to your local machine:

   git clone git@github.com: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,johndoe@example.com,Introduction to Certificates,2023-09-17
   Jane Smith,janesmith@example.com,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.