Skip to content

mgalen007/Imena-Paper-Pop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

20 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ‰ Imena Paper Pop

Generate Beautiful, Polished Invitations for Your Family Events

Imena Paper Pop is a simple yet powerful web application that allows Imena family members to quickly create stunning, professionally-designed invitations for family events, celebrations, and announcements. With just a few clicks, you can generate polished, Imena-branded invitations ready to share with family members and beyond.

Imena Paper Pop


🌟 Features

⚑ Lightning Fast

  • Fill out a simple form with your event details
  • Generate professional invitations in seconds
  • No design skills required!

🎨 Beautiful Design

  • Polished, modern templates with Imena family branding
  • Gradient backgrounds and smooth animations
  • Professional typography using Poppins font
  • Consistent with Imena NewsBox theme (#1A74ED)

πŸ“₯ Easy Sharing

  • Download invitations as high-quality PDFs
  • Share with family members, friends, or anyone
  • Perfect for printing or digital distribution

🎯 Perfect For

  • Family gatherings and reunions
  • Sub-family events (e.g., Wihogora Saturday activities)
  • Celebrations and milestones
  • Work sessions and meetings
  • Achievement showcases
  • Announcements and requests

πŸš€ Quick Start

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn

Installation

  1. Navigate to the project directory:

    cd Imena-Paper-Pop
  2. Install dependencies:

    npm install
  3. Start the server:

    npm start
  4. Open your browser: Navigate to http://localhost:3000

  5. Start creating invitations! πŸŽ‰


πŸ“‹ How to Use

  1. Fill in the form with your event details:

    • Event Title (required)
    • Date (required)
    • Time (required)
    • Location (optional)
    • Organizer (optional)
    • Description (optional)
    • Agenda (optional)
  2. Click "Generate Invitation PDF"

  3. Download your beautiful invitation and share it with your guests!


πŸ—οΈ Tech Stack

Frontend

  • HTML5 - Semantic structure
  • TailwindCSS - Modern, utility-first styling
  • Vanilla JavaScript - Clean, performant interactions

Backend

  • Node.js - Runtime environment
  • Express.js - Web server framework
  • Puppeteer - PDF generation engine

Design

  • Poppins Font - Modern, clean typography
  • Gradient Backgrounds - Eye-catching visuals
  • Smooth Animations - Enhanced user experience
  • Responsive Design - Works on all devices

🎨 Design Philosophy

Imena Paper Pop follows modern web design best practices:

  • Vibrant Colors: Uses the Imena brand color (#1A74ED) with beautiful gradients
  • Premium Feel: Glassmorphism, shadows, and smooth transitions
  • Micro-animations: Engaging hover effects and entrance animations
  • Responsive: Looks great on desktop, tablet, and mobile
  • Accessibility: Semantic HTML and proper contrast ratios

πŸ“ Project Structure

Imena-Paper-Pop/
β”œβ”€β”€ public/
β”‚   β”œβ”€β”€ index.html          # Main landing page
β”‚   └── app.js              # Frontend JavaScript
β”œβ”€β”€ server.js               # Express server & PDF generation
β”œβ”€β”€ package.json            # Dependencies
└── README.md              # This file

πŸ”§ API Endpoints

POST /api/generate-pdf

Generate a PDF invitation from event details.

Request Body:

{
  "eventTitle": "Family Gathering",
  "eventDate": "2026-03-15",
  "eventTime": "10:00",
  "location": "Imena Family Home",
  "organizer": "Wihogora Sub-Family",
  "description": "Join us for a wonderful family gathering",
  "agenda": "10:00 AM - Welcome\n11:00 AM - Activities"
}

Response:

  • Content-Type: application/pdf
  • Downloads PDF file

GET /api/health

Check API status.

Response:

{
  "status": "ok",
  "message": "Imena Paper Pop API is running"
}

🎨 Branding

Imena Paper Pop uses the official Imena family branding:

  • Primary Color: #1A74ED (Imena Blue)
  • Secondary Color: #0d47a1 (Imena Dark)
  • Font: Poppins (Google Fonts)
  • Logo: Circular "I" emblem

All invitations feature:

  • Imena Family logo
  • Consistent color scheme
  • Professional typography
  • Family tagline: "Together we celebrate, together we grow 🌟"

πŸš€ Future Enhancements

Potential features for future versions:

  • Multiple invitation templates
  • Custom color themes
  • Image uploads for event photos
  • Email integration for direct sending
  • RSVP tracking
  • Event reminders
  • Multi-language support
  • Mobile app version

🀝 Contributing

This project was built for the Imena Family Hackathon. Contributions and suggestions are welcome!


πŸ“ License

MIT License - Built with ❀️ for the Imena Family


πŸ‘₯ Credits

Built by: Imena Family Member
For: Imena Family Hackathon
Theme Inspiration: Imena NewsBox


πŸŽ‰ Let's Win This Hackathon!

Imena Paper Pop demonstrates:

  • βœ… Excellent performance and smooth operation
  • βœ… Beautiful, modern UI with premium design
  • βœ… High-quality, polished invitation templates
  • βœ… Practical solution to a real family need
  • βœ… Professional code quality and structure

Together we celebrate, together we grow! 🌟


πŸ“ž Support

For questions or issues, please reach out to the Imena Family tech team.

Happy Inviting! 🎊

About

An invitation generator for different invitations.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors