cherylpinto/HonorBox

HonorBox , is a free and open-source web-based application that allows users to generate and verify certificates effortlessly. It provides a seamless and secure way to issue digital certificates and validate their authenticity

โ˜… 0Forks 0GitHub โ†—Compare

Project website โ†—

README

HonorBox

All Contributors

HonorBox is a free and open-source web-based application that allows users to generate and verify certificates effortlessly. It provides a seamless and secure way to issue digital certificates and validate their authenticity.

๐Ÿš€ Features

  • ๐ŸŒ Web-Based โ€“ No installation required, access from anywhere.
  • ๐Ÿ”“ Open Source โ€“ Completely free to use and modify.
  • ๐Ÿ† Certificate Generation โ€“ Create professional certificates easily.
  • โœ… Certificate Verification โ€“ Verify authenticity using unique IDs.
  • ๐Ÿ“„ Customizable Templates โ€“ Design certificates with your own branding.
  • ๐Ÿ”’ Secure & Reliable โ€“ Uses cryptographic techniques to ensure data integrity.

๐Ÿ› ๏ธ Tech Stack

  • Frontend: React.js, Tailwind CSS
  • Backend: Node.js, Express.js
  • Database: MongoDB
  • Authentication: JWT (JSON Web Tokens)
  • Deployment: Vercel / Netlify (Frontend), Heroku / Render (Backend)

๐Ÿ“ Project Structure

HonorBox/
โ”œโ”€โ”€ Backend/
โ”‚   โ”œโ”€โ”€ config/
โ”‚   โ”‚   โ””โ”€โ”€ db.js
โ”‚   โ”œโ”€โ”€ controllers/
โ”‚   โ”‚   โ”œโ”€โ”€ certificateController.js
โ”‚   โ”‚   โ””โ”€โ”€ imageController.js
โ”‚   โ”œโ”€โ”€ models/
โ”‚   โ”‚   โ”œโ”€โ”€ Certificate.js
โ”‚   โ”‚   โ”œโ”€โ”€ Image.js
โ”‚   โ”‚   โ””โ”€โ”€ User.js
โ”‚   โ”œโ”€โ”€ routes/
โ”‚   โ”‚   โ”œโ”€โ”€ authRoutes.js
โ”‚   โ”‚   โ”œโ”€โ”€ certificateRoutes.js
โ”‚   โ”‚   โ””โ”€โ”€ imageRoutes.js
โ”‚   โ”œโ”€โ”€ index.js
โ”‚   โ”œโ”€โ”€ package.json
โ”‚   โ”œโ”€โ”€ README.md
โ”‚   โ”œโ”€โ”€ .env
โ”‚   โ””โ”€โ”€ .env.example
โ”œโ”€โ”€ Frontend/
โ”‚   โ”œโ”€โ”€ public/
โ”‚   โ”‚   โ””โ”€โ”€ honorbo logo.png
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ App.css
โ”‚   โ”‚   โ”œโ”€โ”€ App.jsx
โ”‚   โ”‚   โ”œโ”€โ”€ index.css
โ”‚   โ”‚   โ”œโ”€โ”€ main.jsx
โ”‚   โ”‚   โ””โ”€โ”€ components/
โ”‚   โ”‚       โ”œโ”€โ”€ About.jsx
โ”‚   โ”‚       โ”œโ”€โ”€ custom.css
โ”‚   โ”‚       โ”œโ”€โ”€ DarkVeil.jsx
โ”‚   โ”‚       โ”œโ”€โ”€ Footer.jsx
โ”‚   โ”‚       โ”œโ”€โ”€ Generate.jsx
โ”‚   โ”‚       โ”œโ”€โ”€ Home.jsx
โ”‚   โ”‚       โ”œโ”€โ”€ Navbar.jsx
โ”‚   โ”‚       โ”œโ”€โ”€ NotFound.jsx
โ”‚   โ”‚       โ””โ”€โ”€ Verify.jsx
โ”‚   โ”œโ”€โ”€ eslint.config.js
โ”‚   โ”œโ”€โ”€ index.html
โ”‚   โ”œโ”€โ”€ package.json
โ”‚   โ”œโ”€โ”€ postcss.config.js
โ”‚   โ”œโ”€โ”€ README.md
โ”‚   โ”œโ”€โ”€ tailwind.config.js
โ”‚   โ”œโ”€โ”€ vercel.json
โ”‚   โ”œโ”€โ”€ vite.config.js
โ”‚   โ””โ”€โ”€ .env.example
โ”œโ”€โ”€ CODE_OF_CONDUCT.md
โ”œโ”€โ”€ CONTRIBUTING.md
โ”œโ”€โ”€ LICENSE
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ .all-contributorsrc

๐Ÿ“Œ Installation

Prerequisites

  • Node.js & npm / yarn installed
  • Git installed

Steps to Run Locally

  1. Clone the repository

    git clone https://github.com/your-username/HonorBox.git
    cd HonorBox
  2. Install dependencies

    npm install  # or yarn install
  3. Start the development server

    npm run dev  # or yarn dev
  4. Open in Browser
    Visit http://localhost:3000 to access HonorBox.

๐ŸŽจ Usage

  1. Generate a Certificate โ€“ Fill in the details and generate a certificate instantly.
  2. Download or Share โ€“ Get a downloadable version or share a public link.
  3. Verify a Certificate โ€“ Enter the certificate ID to check its authenticity.

๐Ÿค Contributing

Contributions are welcome! If youโ€™d like to contribute:

  1. Fork the repository
  2. Create a new branch (feature/your-feature)
  3. Commit your changes
  4. Push the branch and create a Pull Request

๐Ÿ“œ License

HonorBox is licensed under the MIT License โ€“ you are free to use, modify, and distribute it.

๐ŸŒŸ Show Your Support

If you find HonorBox useful, please โญ star the repository and share it with others!


๐Ÿš€ Start generating & verifying certificates with HonorBox today!

Contributors โœจ

Thanks goes to these wonderful people (emoji key):

Rithwik Surya
Rithwik Surya

๐Ÿ’ป
Shivansh Katiyar
Shivansh Katiyar

๐Ÿ“–
Charul192
Charul192

๐Ÿ“– ๐Ÿ’ป
Gourav Kumar Jaiswal
Gourav Kumar Jaiswal

๐Ÿ›
Ramakrushna Biswal
Ramakrushna Biswal

๐Ÿ’ป
Aditya Jolly
Aditya Jolly

๐Ÿ“– ๐Ÿ’ป
Sagar Chavan
Sagar Chavan

๐Ÿ’ป ๐ŸŽจ

This project follows the all-contributors specification. Contributions of any kind welcome!

Contributors

RamakrushnaBiswalallcontributors[bot]Charul192sagarc123AdityaJollyysuryssssCopilotSK8-infigouravKJ

Issues