Skip to content

Latest commit

 

History

History
108 lines (79 loc) · 3.27 KB

README.md

File metadata and controls

108 lines (79 loc) · 3.27 KB
Raw

🏆 Award Certificate Generator (Open Source)

Beta Version 1.0.0 (December 2024)

A modern, user-friendly web application for creating and managing beautiful award certificates in bulk. Perfect for schools, organizations, and events where multiple certificates need to be generated with consistent styling.

Working App Deployed on : https://award-maker.vercel.app/

✨ Features

📑 Bulk Certificate Generation

  • Create multiple certificates at once
  • Consistent styling across all certificates
  • Real-time preview of all certificates

🎨 Customizable Design

  • Adjustable colors for all text elements
  • Custom decorative elements and borders
  • Upload corner images and backgrounds
  • Two layout options: Portrait and Landscape
  • Customizable fonts and text sizes
  • Adjustable opacity for background elements

⚙️ Easy Management

  • Add, edit, and remove recipients
  • Customize signatories and their titles
  • Editable presentation text
  • Real-time preview of changes

📤 Export Options

  • Export to PDF with proper formatting
  • Multiple certificates per page in portrait mode
  • Single certificate per page in landscape mode
  • Maintains aspect ratio for consistent appearance
  • High-quality output

🚀 Getting Started

  1. Clone the repository:
git clone https://github.com/yourusername/award-certificate-generator.git
  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser

💻 Tech Stack

  • Framework: Next.js 14 with TypeScript
  • Styling: Tailwind CSS
  • Icons: Lucide Icons
  • PDF Generation: jsPDF
  • HTML to Image: html2canvas
  • UI Components: Custom shadcn/ui components

🤝 Contributing

We welcome contributions! Here's how you can help:

  • Bug Reports: Open an issue describing the bug and how to reproduce it
  • Feature Requests: Open an issue describing your suggested feature
  • Code Contributions: Submit a pull request with your improvements
  • Documentation: Help improve or translate the documentation

🗺️ Roadmap

  • Additional certificate templates
  • Support for different paper sizes (A4, Letter, etc.)
  • CSV/Excel import for bulk recipient data
  • Save and load certificate designs
  • Additional export formats (PNG, JPEG)
  • Mobile-responsive design
  • Multi-language support
  • Custom font uploads
  • Template sharing system

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Lucide Icons for the beautiful decorative elements
  • Tailwind CSS team for the styling framework
  • Next.js team for the amazing framework
  • shadcn/ui for the component system
  • All contributors who help improve this project

📮 Support

If you encounter any issues or have questions:

  1. Check the Issues page
  2. Open a new issue if your problem isn't already reported
  3. Provide as much detail as possible to help us help you

Made with ❤️ for educators and organizations who need an easy way to create beautiful certificates