Enjoy our curated collection of examples and solutions. Use these patterns to build your own robust and scalable applications. We're going to be shipping new examples weekly. Stay tuned!
- Edge Functions – Edge Functions are currently in Public Beta on Vercel. Read the docs here.
- Solutions – Demos, Architectures and Best Practices
Multiple examples are being featured in vercel.com/templates, visit that page for more advanced filtering options.
Examples that have front matter metadata will create a new Draft template in Contentful, for more steps on how to publish a template, read Publishing Templates.
To quickly start contributing with a new example, run the following commands:
pnpm i
pnpm new-exampleIf the script above isn't used, make sure the example complies with the following:
- It has to be located in either the
solutionsoredge-functionsfolder - It must have a
.gitignoresimilar to plop-templates/example/.gitignore - It must have a
package.jsonsimilar to plop-templates/example/package.json (usage of Next.js is optional). The license should beMIT - It must have a
README.mdsimilar to plop-templates/example/README.md. The example has to be able to include a demo URL (the Vercel team will deploy it!) and if it requires environment variables, it must have a.env.examplefile and instructions on how to set them up. Take bot-protection-datadome as an example.- To customize the Vercel Deploy Button take a look at the docs, useful if the deployment has required environment variables.
- If using Next.js, it must have a
.eslintrc.jsonsimilar to plop-templates/example/.eslintrc.json - All Next.js examples should be using the same styling and layout provided by
@vercel/examples-ui, its usage can be seen in the plop template
If you would like the example to be featured in vercel.com/templates then also add the front matter metadata to the top of the readme, like in bot-protection-datadome. To know all the possible values for each metadata take a look at fields.json.
If you want to add related templates to your template, copy the slug from the other template into the relatedTemplates field, for example for vercel.com/templates/next.js/monorepo-turborepo the slug is monorepo-turborepo, as written in solutions/monorepo/README.md
We use Husky to manage the pre-commit Git hook in this repo. Husky configures hooks automatically during install, so you don't need to do anything special to get them working, but if it fails to install, you can run the following command to install it manually:
pnpm run prepareCode changes automatically go through Prettier and Eslint when you make a commit, please do not skip these steps unless they're broken and in that case let us known by creating an issue.
If you have any questions or suggestions about the docs, feel free to open a discussion, or submit a PR with your suggestions!
- Start a Discussion with a question, piece of feedback, or idea you want to share with the team.
- Open an Issue if you believe you've encountered a bug that you want to flag for the team.