{"id":26744065,"url":"https://github.com/yanikkumar/myblessings","last_synced_at":"2025-03-28T07:17:40.508Z","repository":{"id":283663602,"uuid":"952504241","full_name":"yanikkumar/myblessings","owner":"yanikkumar","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-24T09:18:19.000Z","size":7,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T09:40:54.957Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yanikkumar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-21T11:42:55.000Z","updated_at":"2025-03-24T09:18:23.000Z","dependencies_parsed_at":"2025-03-24T09:40:55.568Z","dependency_job_id":null,"html_url":"https://github.com/yanikkumar/myblessings","commit_stats":null,"previous_names":["yanikkumar/yourbirthday","yanikkumar/myblessings"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yanikkumar%2Fmyblessings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yanikkumar%2Fmyblessings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yanikkumar%2Fmyblessings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yanikkumar%2Fmyblessings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yanikkumar","download_url":"https://codeload.github.com/yanikkumar/myblessings/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245984551,"owners_count":20704798,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-28T07:17:39.683Z","updated_at":"2025-03-28T07:17:40.490Z","avatar_url":"https://github.com/yanikkumar.png","language":"PHP","funding_links":["https://www.buymeacoffee.com/yanikkumar"],"categories":[],"sub_categories":[],"readme":"# My Blessings ![GitHub Stars](https://img.shields.io/github/stars/yanikkumar/myblessings?style=social)\n\n**For your Birthday/Anniversary**\n\nSend a cute Birthday/Anniversary wish to your loved ones. Basic text-wishes are so boring now. Make the person smile with this web-based blessing. Made with a simple **`PHP`** script mixed with some **`Vanilla JS`** for animations and interactions, added with **`TailwindCSS`** for a good-looking User Interface.\n\n**Live at: [myblessings.great-site.net](https://myblessings.great-site.net/)**\n\n## What is this?\n\nThis web application provides a fun and interactive way to send personalized wishes for birthdays and anniversaries. Instead of sending a plain text message, you can generate a special link with animated emojis and a customized message.\n\n### For Normal Users\n\nThis is a simple tool to create fun, shareable wishes for your friends and family. You can create a unique link to send someone for their birthday or anniversary.\n\n#### How to Use?\n\nIt's super easy to use:\n\n1.  **Go to the Generator:** Open your web browser and go to [myblessings.great-site.net/generate-blessings](https://myblessings.great-site.net/generate-blessings)\n2.  **Fill the form:**\n    - Select \"Birthday\" or \"Anniversary\".\n    - Enter the name of the person you're sending the wish to.\n    - Optionally, add your name as the sender.\n    - Optionally, enter the date (birthday or anniversary date). _If you leave this blank, the message will be purely celebratory. If you include the date, a mildly sarcastic message related to the age or years will be added._\n3.  **Generate and Copy:** Click the \"Generate Link\" button. The website will create a special message for you. Click the \"Copy Message\" button to copy the message to your clipboard.\n4.  **Share:** Paste the copied message into WhatsApp, a social media post, or anywhere else you want to share it!\n\nThe person receiving your message will see an animated page with your wishes.\n\n\u003e If you don't want to show the sarcastic message, do not add the date.\n\nIf you like the work, make sure to ⭐ this repo! 🤩 It will help me create some more open-source fun projects.\n\n---\n\n## For Curious Eyes 👀 (and Developers!)\n\nThis project was created with simplicity and ease of use in mind, but also with the potential for extension and contribution. Here's a bit more detail for those who want to get involved:\n\n### Developer's Perspective\n\nAs the developer, I aimed to create a simple, fun, and easily shareable web application using PHP for the backend logic, Tailwind CSS for rapid and consistent styling, and Vanilla JavaScript for dynamic front-end effects. The application generates a unique, shareable link that displays a customized (blessing) message.\n\nThe goal was to move away from boring, plain-text wishes and add some animations and a touch of humor (with the optional sarcastic messages).\n\n### Setting up Locally\n\nIf you want to contribute to this project, or just run it on your own machine, here's how:\n\n1.  **Prerequisites:**\n\n    - PHP (version 7.4 or later is recommended)\n    - A web server (Apache, Nginx, or PHP's built-in server)\n    - Git (optional, for cloning the repository)\n\n2.  **Installation:**\n    - **Clone the repository:**\n      ```bash\n      git clone [https://github.com/yanikkumar/myblessings.git](https://github.com/yanikkumar/myblessings.git)\n      cd myblessings\n      ```\n    - **Set up your web server:**\n      - If you have Apache or Nginx, create a virtual host that points to the project's `public` directory (if you had one). Since this project doesn't have a public directory, just point it to the project root.\n      - If you're using PHP's built-in server:\n      ```bash\n      php -S localhost:8000 -t .  #  Run from the project root\n      ```\n    - **Access the application:** Open your web browser and go to `http://localhost:8000` (or the URL you set up).\n\n## Developer Usage\n\n1.  **Generate a Blessing:**\n\n    - Go to the `generate.php` page.\n    - Select the wish type (Birthday or Anniversary).\n    - Enter the recipient's name.\n    - Optionally, enter the sender's name and the date.\n    - Click the \"Generate Link\" button.\n\n2.  **Share the Blessing:**\n\n    - The application will generate a shareable link.\n    - Copy the link and share it with your friends and family via social media, messaging apps, or email.\n\n3.  **View a Blessing:**\n\n    - When someone clicks on the shared link, they will be directed to the `index.php` page, where they can view the personalized blessing message.\n\n## File Structure\n\n- `index.php`: Displays the personalized blessing message.\n- `generate.php`: Form to generate shareable blessing links.\n- `README.md`: Project documentation.\n\n### Contribution\n\nI welcome contributions to make this project even better! If you have any ideas for new features or improvements, feel free to submit a pull request or open an issue.Here are some ways you can contribute:\n\n- **Add more messages:** The messages in `index.php` can be expanded.\n- **Improve the animations:** The JavaScript in `index.php` could be enhanced.\n- **Add features:** Think of new ways to make the more interactive and engaging.\n- **Fix bugs:** If you find any issues, please report them or submit a pull request with a fix.\n\n1.  Fork the repository.\n2.  Create a new branch for your feature or bug fix.\n3.  Commit your changes.\n4.  Push to your fork.\n5.  Submit a pull request.\n\nIf you like the work, make sure to ⭐ this repo! 🤩 It will help me create some more open-source fun projects.\n\n## Developer\n\n- [Yanik Kumar](https://youtube.com/yanikkumarvlogs)\n\n## License\n\nThis project is open-source.\n\n---\n\n## Sponsor this project\n\nIf you find this project helpful and want to support its development, please consider sponsoring me. Your contributions will help me dedicate more time to improving the project and adding new features.\nYou can sponsor me on:\n\n- [GitHub](https://github.com/yanikkumar)\n- [Buy Me a Coffee](https://www.buymeacoffee.com/yanikkumar)\n\n---\n\n## Previous Version\n\nThe previous version of this project is hosted at: 👇🏻\n[https://yourbirthday.great-site.net](https://yourbirthday.great-site.net)\n\nThe previous version had a different URL structure, this is kept for historical reasons.\n\nDirect link parameters for the old version:\n\n[https://yourbirthday.great-site.net/?name=Yanik\u0026sender=BelieveMaster\u0026dob=1998-03-21](https://yourbirthday.great-site.net/?name=name=Yanik\u0026sender=BelieveMaster\u0026dob=1998-03-21)\n\n- name={BIRTHDAY_PERSON_NAME}\n- sender={NAME_OF_THE_PERSON_SENDING_WISHES}\n- (optional) dob={DOB_OF_BIRTHDAYPERSON} FORMAT: `YYYY-MM-DD`\n\n\u003e If you don't want to show the sarcastic message, do not add DOB in params.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyanikkumar%2Fmyblessings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyanikkumar%2Fmyblessings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyanikkumar%2Fmyblessings/lists"}