hashnode-postcard/README.md

Hashnode blogpost cards for your website

# Hashnode Postcard

[Hashnode](https://hashnode.com/) blogpost cards for your website using a single HTML element. import it anywhere you want.

![hashnode-postcard demo](https://ik.imagekit.io/ayu/hashnode-postcard-demo_wRLT1g_-o.png?updatedAt=1626945637219)

## install

```bash
npm i hashnode-postcard
```

or

```bash
yarn add hashnode-postcard
```

## usage

- using import statement:

```html
<hashnode-postcard data-username="ayushcodes"></hashnode-postcard>

<script type="module">
  import "hashnode-postcard";
</script>
```

- using script tag:

```html
<hashnode-postcard data-username="ayushcodes"></hashnode-postcard>

<script
  src="https://unpkg.com/hashnode-postcard@latest/dist/hashnode-postcard.umd.js"
  type="module"
></script>
```

## demo

- [import demo & script demo](https://stackblitz.com/edit/hashnode-postcard-demo?file=index.html,index.js)
- [react/nextjs demo](https://stackblitz.com/edit/hashnode-postcard-react-nextjs-demo?file=pages%2Findex.js)

## api

- `<hashnode-postcard data-username="YOUR_HASHNODE_USERNAME"></hashnode-postcard>`

### customize

Following data attributes are available to customize the postcard.

| data attribute   | description                                | examples   | type                          |
| ---------------- | ------------------------------------------ | ---------- | ----------------------------- |
| data-username    | your hashnode username                     | ayushcodes | required                      |
| data-width       | width of the postcard                      | 600px      | optional                      |
| data-height      | height of the blogposts wrapper            | 500px      | optional                      |
| data-cover-image | to show the post cover images              | true       | optional (default is true)    |
| data-followers   | to show the number of followers            | false      | optional (default is true)    |
| data-brief       | to show the brief description of blogposts | true       | optional (default is true)    |
| data-theme       | to change the theme of the interface       | default    | optional (default is default) |

#### available themes

- default
- devto
- hashnode-light-mode
- dracula
- nord-light
- nord-dark