An open API service indexing awesome lists of open source software.

https://github.com/omkarspace/honorink

HonorInk is an educational web application built with React 18 and Vite that enables users to create custom course completion certificates in PDF format. The application features an intuitive interface for customizing certificate details including name, course information, completion date, and skills covered,
https://github.com/omkarspace/honorink

certificate-generator customizable-certificates educational-projects html2pdfjs linkedin-learning open-source pdf-export pdf-generation react-router-dom reactjs tailwind-css udemy

Last synced: about 2 months ago
JSON representation

HonorInk is an educational web application built with React 18 and Vite that enables users to create custom course completion certificates in PDF format. The application features an intuitive interface for customizing certificate details including name, course information, completion date, and skills covered,

Awesome Lists containing this project

README

          

```markdown
# HonorInk โ€“ Certificate Generator

<<<<<<< HEAD
HonorInk is a modern web application for generating beautiful, custom course completion certificates. Built with React, Vite, and TailwindCSS, it offers a fast, responsive, and accessible user experience.

> **Note:** This project is for educational purposes only.

## ๐Ÿš€ Features

- ๐ŸŽ“ Generate professional certificates for Udemy, LinkedIn Learning, and Coursera
- ๐Ÿ“ Customizable certificate fields (name, course, date, instructor, etc.)
- ๐Ÿ“ฅ Download certificates as high-quality PDFs or PNG images
- ๐Ÿ‘€ Preview certificates before downloading
- โœ… Form validation with user-friendly error messages
=======
HonorInk is a modern web application for generating beautiful, custom course completion certificates in PDF format. Built with React, Vite, and TailwindCSS, it offers a fast, responsive, and accessible user experience.

> **Note:** This project is for educational purposes only.

---

## ๐Ÿš€ Features

- ๐ŸŽ“ Generate professional certificates for Udemy, LinkedIn, and more
- ๐Ÿ“ Customizable certificate fields (name, course, date, etc.)
- ๐Ÿ“ฅ Download certificates as high-quality PDFs
>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280
- โšก Blazing-fast UI with Vite and React
- ๐ŸŒˆ Responsive, modern design with TailwindCSS
- ๐Ÿงฉ Modular component structure
- ๐Ÿ” Accessible and keyboard-friendly navigation
- ๐Ÿ› ๏ธ Easy to extend for other certificate styles
<<<<<<< HEAD
- ๐ŸŽจ Consistent styling across all certificate templates

## ๐Ÿ› ๏ธ Tech Stack

- [React](https://react.dev/) - UI framework
- [Vite](https://vitejs.dev/) - Build tool and dev server
- [TailwindCSS](https://tailwindcss.com/) - CSS framework
- [shadcn/ui](https://ui.shadcn.com/) - Component library (Radix UI + Tailwind)
- [html2pdf.js](https://github.com/eKoopmans/html2pdf.js) - PDF generation
- [html2canvas](https://html2canvas.hertzen.com/) - Image export
- [React Router](https://reactrouter.com/) - Client-side routing
- [Lucide React](https://lucide.dev/) - Icon library
=======

---

## ๐Ÿ› ๏ธ Tech Stack

- [React](https://react.dev/)
- [Vite](https://vitejs.dev/)
- [TailwindCSS](https://tailwindcss.com/)
- [html2pdf.js](https://github.com/eKoopmans/html2pdf.js)
- [React Router](https://reactrouter.com/)

---
>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280

## ๐Ÿ“ฆ Installation & Setup

1. **Clone the repository**
```bash
git clone https://github.com/yourusername/honorink.git
<<<<<<< HEAD
cd honorink
```

=======
cd honorink/HonorInk
```
>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280
2. **Install dependencies**
```bash
npm install
```
<<<<<<< HEAD

=======
>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280
3. **Start the development server**
```bash
npm run dev
```
<<<<<<< HEAD

4. **Open the app**
Visit [http://localhost:5173](http://localhost:5174) in your browser.
=======
4. **Open the app**
Visit [http://localhost:5173](http://localhost:5173) in your browser.

---
>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280

## ๐Ÿ—‚๏ธ Project Structure

```
src/
<<<<<<< HEAD
โ”œโ”€โ”€ components/ # React components
โ”‚ โ”œโ”€โ”€ CertificateForm.jsx # Reusable form component
โ”‚ โ”œโ”€โ”€ CourseraCertificate.jsx # Coursera certificate template
โ”‚ โ”œโ”€โ”€ Home.jsx # Landing page
โ”‚ โ”œโ”€โ”€ LinkedInCertificate.jsx # LinkedIn certificate template
โ”‚ โ”œโ”€โ”€ Navbar.jsx # Navigation component
โ”‚ โ”œโ”€โ”€ NotFound.jsx # 404 page
โ”‚ โ””โ”€โ”€ UdemyCertificate.jsx # Udemy certificate template
โ”œโ”€โ”€ App.jsx # Main app component
โ”œโ”€โ”€ App.css # Global styles
โ”œโ”€โ”€ index.css # CSS imports
โ””โ”€โ”€ main.jsx # Entry point

public/ # Static assets
โ”œโ”€โ”€ favicon.ico
โ”œโ”€โ”€ linkedin_background.png
โ”œโ”€โ”€ linkedin_learning.png
โ”œโ”€โ”€ linkedin_stamp.png
โ”œโ”€โ”€ udemy_logo.png
โ””โ”€โ”€ coursera assets (to be added)
```

## ๐Ÿ’ก Usage

1. Select a certificate platform from the home page
2. Fill in the certificate details in the form
3. Preview the generated certificate
4. Edit details if needed or download as PDF/PNG
=======
โ”œโ”€โ”€ components/ # Reusable React components
โ”œโ”€โ”€ context/ # Global state management (React Context)
โ”œโ”€โ”€ assets/ # Images and static assets
โ”œโ”€โ”€ styles/ # Global styles
โ”œโ”€โ”€ utils/ # Utility functions (e.g., PDF generator)
โ”œโ”€โ”€ App.jsx # Main app component
โ”œโ”€โ”€ main.jsx # Entry point
```

---

## ๐Ÿ’ก Usage

1. Fill in the certificate details in the form
2. Preview the generated certificate
3. Download as PDF

---
>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280

## โ™ฟ Accessibility

- Semantic HTML and ARIA labels
- Keyboard navigation support
- High-contrast, readable color scheme
<<<<<<< HEAD
- Screen reader friendly
=======

---

## ๐Ÿ“ฑ PWA Support

- Installable on desktop and mobile
- Offline support (coming soon)

---
>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280

## ๐Ÿงช Testing

- Run tests with:
```bash
npm run test
```

<<<<<<< HEAD
=======
---

>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280
## ๐Ÿค Contributing

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/YourFeature`)
3. Commit your changes (`git commit -m 'feat: add YourFeature'`)
4. Push to the branch (`git push origin feature/YourFeature`)
5. Open a Pull Request

<<<<<<< HEAD
=======
---

>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280
## ๐Ÿ›ก๏ธ Security & Privacy

- All data is processed client-side. No data is stored or transmitted to any servers.

<<<<<<< HEAD
## ๐ŸŽ๏ธ Performance

- Optimized PDF and image generation
- Minimal bundle size with code splitting
- Efficient rendering with React
=======
---

## ๐ŸŽ๏ธ Performance

- Optimized for fast load times and minimal bundle size
- Efficient rendering and code splitting

---
>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280

## ๐ŸŒ Browser Support

- Chrome (latest)
- Firefox (latest)
- Safari (latest)
- Edge (latest)

<<<<<<< HEAD
## ๐Ÿž Troubleshooting

- **PDF generation fails:**
- Ensure all form fields are filled correctly
=======
---

## ๐Ÿž Troubleshooting

- **PDF generation fails:**
- Ensure all form fields are filled
>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280
- Check browser console for errors
- **Certificate preview not showing:**
- Clear browser cache
- Refresh the page

<<<<<<< HEAD
=======
---

>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280
## ๐Ÿ“„ License

This project is licensed under the MIT License.

<<<<<<< HEAD
## โš ๏ธ Disclaimer

This project is intended for educational purposes only. Users are responsible for ensuring their use of this tool complies with relevant policies and regulations.
=======
---

## โš ๏ธ Disclaimer

This project is intended for educational purposes only. Users are responsible for ensuring their use of this tool complies with relevant policies and regulations.

โ”‚ โ””โ”€โ”€ pdfGenerator.js
โ”œโ”€โ”€ styles/
โ””โ”€โ”€ App.jsx
```

## Usage

1. Fill in the certificate details in the form
2. Preview the generated certificate
3. Download as PDF

## Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## Development

```bash
# Run development server
npm run dev

# Build for production
npm run build

# Run tests
npm run test
```

## Security

This application runs entirely on the client side. No data is stored or transmitted to any servers.

## Performance

- Optimized PDF generation
- Minimal bundle size
- Efficient rendering

## Browser Support

- Chrome (latest)
- Firefox (latest)
- Safari (latest)
- Edge (latest)

## Troubleshooting

Common issues and solutions:

1. PDF generation fails
- Ensure all form fields are filled correctly
- Check browser console for errors

2. Certificate preview not showing
- Clear browser cache
- Refresh the page

## License

This project is licensed under the MIT License.

## Disclaimer

This project is intended for educational purposes only. Users are responsible for ensuring their use of this tool complies with relevant policies and regulations.
>>>>>>> e501412cee8a8d731fef59835af1ee644c96d280
```