# 🏳️Add Vercel to Plugin deployment

**URL:** <https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920>\
**Category:** Help us improve Penpot\
**Tags:** plugins, deployment, vercel\
**Created:** [February 23, 2025, 12:05pm UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920 "2025-02-23T12:05:14Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![BDV](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/bdv/32/8012_2.png) [@BDV](https://community.penpot.app/u/BDV)\
**Post date:** [February 23, 2025, 12:05pm UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/1 "2025-02-23T12:05:14Z")

</div>

Is it possible to add [https://vercel.com/](https://vercel.com/) to [3. Deployment](https://help.penpot.app/plugins/deployment/) page?

---

<div class="post-metadata">

**Author:** ![carolina.portugal](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/carolina.portugal/32/36_2.png) [@carolina.portugal](https://community.penpot.app/u/carolina.portugal)\
**Post date:** [February 25, 2025, 12:27pm UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/2 "2025-02-25T12:27:40Z")

</div>

That would be a great addition. If someone creates the necessary documentation for adding Vercel to the Deployment page, it would be an awesome contribution.

Let us know if you’re interested in working on it!

---

<div class="post-metadata">

**Author:** ![BDV](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/bdv/32/8012_2.png) [@BDV](https://community.penpot.app/u/BDV)\
**Post date:** [February 25, 2025, 4:34pm UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/3 "2025-02-25T16:34:42Z")

</div>

> [@carolina.portugal](#):
>
> Let us know if you’re interested in working on it!

My answer depends on what will happen to the following topic…

> [@Unmaintained GitHub Penpot plugin examples](https://community.penpot.app/t/unmaintained-github-penpot-plugin-examples/7910):
>
> Is it possible to use [renovatebot](https://github.com/renovatebot/renovate) or [dependabot](https://github.com/dependabot) to keep the dependencies up to date for the Plugin examples? Because now the examples uses older versions, the latest Penpot/plugin-styles is currently V1.1.0 Also don’t forget of a new GitHub release if applicable. I created a pull request to update the vue example

---

<div class="post-metadata">

**Author:** ![BDV](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/bdv/32/8012_2.png) [@BDV](https://community.penpot.app/u/BDV)\
**Post date:** [March 19, 2025, 5:50pm UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/4 "2025-03-19T17:50:37Z")

</div>

I am in the process of adding Vercel to the documentation for Plugin Deployment but am running into some problems.

problem is that I cannot add the images in the same way as this was done for the rest of the documentation and don’t know if you use standard dimensions and format for puctures or not.  
Should I place the image in a separeta folder and then specify the relevant path?  
I think it is this folder but am not sure: penpot/docs/img/plugins

 ![afbeelding](https://europe1.discourse-cdn.com/flex017/uploads/penpot/original/2X/7/7498d3c3b25f17c7824089350332f54f11884a36.png)

Same with video’s and what dimensions do you use for videos and how do you set the dimensions of a video?

 ![afbeelding](https://europe1.discourse-cdn.com/flex017/uploads/penpot/original/2X/6/6d35230f70330540daabcfe9a44e8ef05abf1dee.png)

Below the PR, its a draft for the moment…

> <https://github.com/penpot/penpot/pull/6117>
>
> \### Related Ticket
> 
> 
> 
> \### Summary
> 
> Add documentation for https://vercel.co…m to deploy plugin
> 
> \### Steps to reproduce 
> 
> \### Checklist
> 
> \- \[\] Choose the correct target branch; use \`develop\` by default.
> \- \[\] Provide a brief summary of the changes introduced.
> \- \[\] Add a detailed explanation of how to reproduce the issue and/or verify the fix, if applicable.
> \- \[\] Include screenshots or videos, if applicable.
> \- \[\] Add or modify existing integration tests in case of bugs or new features, if applicable.
> \- \[\] Check CI passes successfully.
> \- \[\] Update the \`CHANGES.md\` file, referencing the related GitHub issue, if applicable.

@carolina.portugal or @myfunnyandy could you help with explaining how the documentations is build up when using pictures and/or videos?

---

<div class="post-metadata">

**Author:** ![myfunnyandy](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/myfunnyandy/32/54_2.png) [@myfunnyandy](https://community.penpot.app/u/myfunnyandy)\
**Post date:** [March 28, 2025, 1:18pm UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/5 "2025-03-28T13:18:21Z")

</div>

> [@BDV](#):
>
> I think it is this folder but am not sure: penpot/docs/img/plugins

You thought right; that’s the folder for the images related to plugins doc.

About the images and videos specs, I’ll copy/paste our recommendations here. This is from a WIP internal guide, we intend to improve it and publish it eventually.

### Images

- Size: 672px is the maximum width at which images can be displayed. The only reason for exceeding this width is that the image is intended to be viewed enlarged ([example](https://help.penpot.app/img/interface/dashboard-dark.webp)).
- Format: WebP high-quality images with significantly smaller sizes than conventional formats like PNG and JPEG.

### Videos

- Size: Same as images.
- Format: mp4.
- Duration: As short as possible.
- Configuration: autoplay must never be on for [accessibility reasons](https://www.boia.org/blog/why-autoplay-is-an-accessibility-no-no).

I hope it helps, and I’m glad to see the progress on this contribution!

---

<div class="post-metadata">

**Author:** ![BDV](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/bdv/32/8012_2.png) [@BDV](https://community.penpot.app/u/BDV)\
**Post date:** [March 31, 2025, 6:40am UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/6 "2025-03-31T06:40:32Z")

</div>

Thanks for the information.  
Weird that you ask to use WebP format while the current images are all in PNG format.  
Also, the naming of the images is not consistent, one part starts with a number and the rest is without a prefix, sometimes ‘\_’ is used as a separator and in other cases ‘-’ …

> [@myfunnyandy](#):
>
> ### Images
> 
> - Size: 672px is the maximum width at which images can be displayed. The only reason for exceeding this width is that the image is intended to be viewed enlarged ([example](https://help.penpot.app/img/interface/dashboard-dark.webp)).
> - Format: **WebP** high-quality images with significantly smaller sizes than conventional formats like PNG and JPEG.

 ![afbeelding](https://europe1.discourse-cdn.com/flex017/uploads/penpot/original/2X/e/e7d53804f6735062fe5078097a5a4a4ad5e69d78.png)

---

<div class="post-metadata">

**Author:** ![BDV](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/bdv/32/8012_2.png) [@BDV](https://community.penpot.app/u/BDV)\
**Post date:** [March 31, 2025, 4:54pm UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/7 "2025-03-31T16:54:06Z")

</div>

This is a standard table for website images

 ![Screenshot_20250331_185149_Firefox](https://europe1.discourse-cdn.com/flex017/uploads/penpot/original/2X/1/107e92491d2fc2bbfaabfab7d70ea6255f0999d4.jpeg)

So I guess ratio 3:2 and a max 1200x630 for images

[Source](https://tiny-img.com/blog/best-image-size-for-website/)

---

<div class="post-metadata">

**Author:** ![BDV](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/bdv/32/8012_2.png) [@BDV](https://community.penpot.app/u/BDV)\
**Post date:** [April 2, 2025, 5:39am UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/8 "2025-04-02T05:39:34Z")

</div>

PR is ready to be merged as is this PR [📚 Update api.md by BDVGitHub · Pull Request #6191 · penpot/penpot · GitHub](https://github.com/penpot/penpot/pull/6191)

---

<div class="post-metadata">

**Author:** ![myfunnyandy](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/myfunnyandy/32/54_2.png) [@myfunnyandy](https://community.penpot.app/u/myfunnyandy)\
**Post date:** [April 4, 2025, 1:42pm UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/9 "2025-04-04T13:42:37Z")

</div>

Actually, compared to the rest of the sections at the User Guide, the image format used at the plugins doc is the exception. The reason is that it was done before we wrote down the recommendations. We’ll probably replace these PNGs for WepPs in one of the updates.

---

<div class="post-metadata">

**Author:** ![BDV](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/bdv/32/8012_2.png) [@BDV](https://community.penpot.app/u/BDV)\
**Post date:** [April 11, 2025, 7:54am UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/10 "2025-04-11T07:54:39Z")

</div>

> [@carolina.portugal](#):
>
> That would be a great addition. If someone creates the necessary documentation for adding Vercel to the Deployment page, it would be an awesome contribution.

@carolina.portugal Apparently, not everyone within Penpot thinks the same about this as no one has already taken the time to review the PR [📚 Update 3.Deployment by BDVGitHub · Pull Request #6117 · penpot/penpot · GitHub](https://github.com/penpot/penpot/pull/6117)

---

<div class="post-metadata">

**Author:** ![BDV](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/bdv/32/8012_2.png) [@BDV](https://community.penpot.app/u/BDV)\
**Post date:** [May 16, 2025, 3:56am UTC](https://community.penpot.app/t/add-vercel-to-plugin-deployment/7920/11 "2025-05-16T03:56:45Z")

</div>

How complex and how many adjustments/rules can it take until someone gets frustrated and makes a misstep 😔
