Copii. Ready to use fully functional copy button for GitHub README files ๐Ÿ“„ ๐ŸŽ‰

Copii. Ready to use fully functional copy button for GitHub README files ๐Ÿ“„ ๐ŸŽ‰

ยท

8 min read

Meet Copii ๐Ÿ“„

Hello everyone!! Have you always wanted to add a copy button in your README files in GitHub? Then you have found the right project. With Copii, you can easily add a copy button in your markdown files. There are 3 types of button you can add/use ๐Ÿ‘‡.

UPDATE: Even if it opens in new tab, now it gets closed automatically

  1. copy

  2. copy

  3. copy

You can click on any of the above buttons and don't worry, you will be redirected back to the same blog post you are reading...

Interesting part comes here, now check your clipboard after clicking any one of the above buttons. You will find hello there.

The best part of this project is that it is really real world ๐Ÿ™€

You can contribute to all the 50 million+ repositories in the world by adding a Copy button to all the code snippets and examples in readme files

The result can be from this

image.png

to this ๐Ÿ‘‡

image.png

Read more to find out how to use this and how I made it for the Vercel Hashnode Hackathon.


Demo

copii-demo-ii.gif

How to use Copii ๐Ÿ‘‡

image.png

  • Check the check box if you want Dark Mode in redirecting page ( optional )

image.png

  • Enter the text/code you want to be copied when the user clicks on Copy button in README file

image.png

  • Enter the URL ( optional ) for custom logo in redirecting page

image.png

  • Click on Generate

image.png

  • Now you will be able to see 3 buttons that you can use

image.png

  • Click on any of the button to copy its markdown code. When a user clicks on any of button in README or any other rendered markdown file, user will be taken to https://copii.vercel.app/?ct=hi( for example ) and the text/code gets copied to clipboard there. Now, the user will be redirected back to same part webpage/github readme back with the help of History API

  • Paste the markdown code in your markdown file/readme file and you are good to go ๐Ÿ˜ฒ

  • Visit GitHub repo for more real world examples.


demo

---

  1. GitHub repo

  2. Website homepage


The situation

First of all, thanks a lot for reading my first blog post ever.

This might be the most awkward sub heading here. In this section I would like to give some reasons for the absence of best practices, good comments, meaningful commit messages and other good stuff in Copii's codebase.

But I will ensure that I will refactor the code in my free time ;D

I first saw the post about this hackathon on 23rd January 2021. At that time I thought I will not be able to participate in this hackathon because of EXAMS ๐Ÿ˜–. I had exams starting from 25th of January to 5th of February. But yesterday I rolled up my sleeves and started working on this project. This is the first project I have worked on alone. Another one I can call a project is the Netflix clone ๐Ÿ˜ž that I made. But I would not assume it as a project because I took the help of some YouTube videos to build it. So this is kind of my first project and fortunately it also happened to be my first project for a hackathon ๐Ÿ˜. I had this project idea from a long time ( I guess about some 4-5 months ), but I did not find time to start it. This is also the reason for less number of features in the app and "not so clean" code...


Features

image.png

  • Dark Mode for redirection page.

  • Support for custom logo in redirection page.

  • Can be used to copy upto 1,500 characters ( can vary depending upon the length of URL of custom logo ).

  • And many more coming very soon...


Tech Stack ๐Ÿ“š

This might be the most boring tech stack of all time. But I really wanted to use the awesome framework of React - Next.js by Vercel โ–ฒ. I also wanted my site to be lightning fast โšก๏ธ. Vercel is also a cherry on top for speed of the website. So I went with -

  1. HTML

  2. CSS

  3. Vanilla Javascript

  4. Vercel ( formerly Zeit ) for hosting

โš ๏ธ Copii app highly relies on query parameters.

My stack requires no maintenance, has perfect Lighthouse scores, will never have any security vulnerability, is based on open standards, is portable, has an instant dev loop, has no build step andโ€ฆ will outlive any other stack.

-by Steren Giannini


Challenges Faced

  1. Special characters

    • Characters such as & and # created a problem because the browser assumed it to be parts of the URL and not a part of the copying text.
    • So I had to convert them to some special characters before appending them to the URL. I used some combination of characters such as ยฌ, ฮฉ, รŸ, etc.. Here's the snippet that does that
    Encoding

    encode.png

Decoding

decode.png

  • I am still facing problems in converting #, for now I am converting it to [hashtag]
  1. URLSearchParams API
    • URLSearchParams API does not work on Internet Explorer. So I took the help of StackOverflow and found the following code block

queryparams.png

  1. Responsiveness
    • From the start(yesterday morning), I wanted to make the website responsive with the least effort and less code. I was almost done with the website, but I had a hard time making the position of blob responsive to screen sizes. Now it looks good on mobiles and laptops

These are some of the major challenges faced ๐Ÿ˜…


PR's are welcome ๐Ÿ‘จ๐Ÿปโ€๐Ÿ’ป


Thanks ๐Ÿ™

That's all for now.

Thanks to Hashnode team for conducting such wonderful hackathon

Oh I forgot to mention, as a tribute to nation, the links in the footer represent the colours in Indian flag ๐Ÿ‡ฎ๐Ÿ‡ณ

THANKS A LOT for reading my first blog post till the end

footer.png

Did you find this article valuable?

Support Lalit by becoming a sponsor. Any amount is appreciated!

ย