-
@@ -15,7 +14,7 @@
{% metagen
title=title or metadata.title,
- desc=desc or metadata.desc,
+ desc=desc or metadata.desc or description or metadata.description,
url="https://help.penpot.app" + page.url,
img="https://help.penpot.app/img/th-help-center.jpg",
img_alt=alt,
diff --git a/docs/contributing-guide/coc/index.njk b/docs/contributing-guide/coc/index.njk
index b9e3ffa86e..43f310788b 100644
--- a/docs/contributing-guide/coc/index.njk
+++ b/docs/contributing-guide/coc/index.njk
@@ -1,5 +1,6 @@
---
title: 04· Code of Conduct
+desc: Learn about contributing to the Penpot project! This page outlines the Code of Conduct, reporting bugs, translations, core code contributions, & more.
---
Code of conduct
diff --git a/docs/contributing-guide/code-contributions/index.njk b/docs/contributing-guide/code-contributions/index.njk
index 619295579c..2c9ef6b517 100644
--- a/docs/contributing-guide/code-contributions/index.njk
+++ b/docs/contributing-guide/code-contributions/index.njk
@@ -1,5 +1,6 @@
---
title: 03· Core code contributions
+desc: Learn how to contribute to Penpot's open-source design collaboration platform. Find guidelines for bug reporting, code contributions & more.
---
Core code contributions
diff --git a/docs/contributing-guide/index.njk b/docs/contributing-guide/index.njk
index d6b0a74caa..b46ecd98ed 100644
--- a/docs/contributing-guide/index.njk
+++ b/docs/contributing-guide/index.njk
@@ -1,5 +1,6 @@
---
title: Contributing
+desc: Learn how to contribute to Penpot, the open-source design collaboration platform! Find guides on bug reporting, translations, code contributions, and more.
eleventyNavigation:
key: Contributing
order: 3
diff --git a/docs/contributing-guide/libraries-templates/index.njk b/docs/contributing-guide/libraries-templates/index.njk
index ce99f3a0f0..2c477f433f 100644
--- a/docs/contributing-guide/libraries-templates/index.njk
+++ b/docs/contributing-guide/libraries-templates/index.njk
@@ -1,5 +1,6 @@
---
title: 05· Libraries & Templates
+desc: Contribute to Penpot's libraries & templates! Learn how to share your files and access resources. Try Penpot - It's free!
---
Libraries & templates
diff --git a/docs/contributing-guide/reporting-bugs/index.njk b/docs/contributing-guide/reporting-bugs/index.njk
index 2b385f3e0d..e424af52bc 100644
--- a/docs/contributing-guide/reporting-bugs/index.njk
+++ b/docs/contributing-guide/reporting-bugs/index.njk
@@ -1,5 +1,6 @@
---
title: 01· Reporting bugs
+desc: Learn how to contribute to Penpot, the open-source design and prototyping platform! Find guidelines for reporting bugs, translations, & code contributions.
---
Reporting bugs
diff --git a/docs/contributing-guide/translations/index.njk b/docs/contributing-guide/translations/index.njk
index 2d5bfae2ba..da7b15a0cb 100644
--- a/docs/contributing-guide/translations/index.njk
+++ b/docs/contributing-guide/translations/index.njk
@@ -1,5 +1,6 @@
---
title: 02· Translations
+desc: Contribute to Penpot! Learn how to translate Penpot into your language using Weblate. Add new translations, languages, or edit existing ones today.
---
Translations
diff --git a/docs/index.njk b/docs/index.njk
index f5b601f7f8..66a57a322a 100644
--- a/docs/index.njk
+++ b/docs/index.njk
@@ -1,5 +1,6 @@
---
title: Help center
+desc: Find user guides, technical documentation, plugin info, FAQs, and contributing guidelines in Penpot's help center. Join the open-source community!
layout: layouts/home.njk
twitter: "@penpotapp"
image: img/placeholder.png
diff --git a/docs/plugins/api.md b/docs/plugins/api.md
index e378b6a728..9abf6a9fa7 100644
--- a/docs/plugins/api.md
+++ b/docs/plugins/api.md
@@ -1,6 +1,7 @@
---
layout: layouts/plugins.njk
title: 4. API
+desc: Create, deploy, and use the Penpot plugin API with our comprehensive documentation. Get started today and expand Penpot's capabilities.
---
# Penpot plugins API
diff --git a/docs/plugins/beta-changelog.md b/docs/plugins/beta-changelog.md
index 599f2bb97f..1f58235752 100644
--- a/docs/plugins/beta-changelog.md
+++ b/docs/plugins/beta-changelog.md
@@ -1,5 +1,7 @@
---
layout: layouts/plugins-no-sidebar.njk
+title: Beta changelog
+desc: See the Penpot plugin API changelog for version 1.0! Find breaking changes, deprecations, new features, and updated documentation. Try Penpot for free.
---
# Beta changelog
diff --git a/docs/plugins/create-a-plugin.md b/docs/plugins/create-a-plugin.md
index 39736e2390..80c4a08df6 100644
--- a/docs/plugins/create-a-plugin.md
+++ b/docs/plugins/create-a-plugin.md
@@ -1,6 +1,7 @@
---
layout: layouts/plugins.njk
title: 2. Create a Plugin
+desc: Dive into Penpot plugin development! This guide covers creating plugins from scratch or using templates, libraries, API communication, & deployment.
---
# Create a Plugin
diff --git a/docs/plugins/deployment.md b/docs/plugins/deployment.md
index a225d0a58f..d18616623f 100644
--- a/docs/plugins/deployment.md
+++ b/docs/plugins/deployment.md
@@ -1,6 +1,7 @@
---
layout: layouts/plugins.njk
title: 3. Deployment
+desc: Deploy your free Penpot plugins! Learn about Netlify, Cloudflare, Surge & Penpot submission in this guide. Build and share your creations.
---
# Deployment
diff --git a/docs/plugins/examples-templates.md b/docs/plugins/examples-templates.md
index c5c1105f44..1836b132c2 100644
--- a/docs/plugins/examples-templates.md
+++ b/docs/plugins/examples-templates.md
@@ -1,6 +1,7 @@
---
layout: layouts/plugins.njk
title: 5. Examples and templates
+desc: Learn to create shapes, text, layouts, components, themes, and interactive prototypes. Start building now! See Penpot plugins with examples & templates!
---
# Examples and templates
@@ -117,7 +118,6 @@ Just a friendly reminder that it's important to have the comment permissions<
Comments example
-
## 5.2. Templates
As we mentioned in the Create a plugin section, we've got two great options for you to get started with your plugin.
diff --git a/docs/plugins/faq.md b/docs/plugins/faq.md
index d883b39d61..4050358597 100644
--- a/docs/plugins/faq.md
+++ b/docs/plugins/faq.md
@@ -1,6 +1,7 @@
---
layout: layouts/plugins.njk
title: 6. FAQ
+desc: Find answers to common questions about plugin development, from choosing the right Node version to creating components. See Penpot plugins!
---
# FAQ
diff --git a/docs/plugins/getting-started.md b/docs/plugins/getting-started.md
index 89f42f61cb..b2d2e5e9f5 100644
--- a/docs/plugins/getting-started.md
+++ b/docs/plugins/getting-started.md
@@ -1,6 +1,7 @@
---
layout: layouts/plugins.njk
title: 1. Getting started
+desc: Dive into Penpot plugins! Extend Penpot's functionality by automating tasks and adding new features using JavaScript, HTML, & CSS. Get started now!
---
# Getting started
diff --git a/docs/plugins/index.njk b/docs/plugins/index.njk
index 3390db4b36..63accb361a 100644
--- a/docs/plugins/index.njk
+++ b/docs/plugins/index.njk
@@ -1,6 +1,7 @@
---
layout: layouts/plugins-home.njk
title: Plugins
+desc: "Get started with Penpot Plugins: Installation, development, and deployment. Access API documentation, examples, templates, and FAQs."
eleventyNavigation:
key: Plugins
order: 5
diff --git a/docs/technical-guide/configuration.md b/docs/technical-guide/configuration.md
index f944dbd453..7fac87c157 100644
--- a/docs/technical-guide/configuration.md
+++ b/docs/technical-guide/configuration.md
@@ -1,5 +1,6 @@
---
title: 2. Penpot Configuration
+desc: Learn about self-hosting, configuration via environment variables, and authentication providers. Try Penpot - It's free! See Penpot's technical guide.
---
# Penpot Configuration
diff --git a/docs/technical-guide/developer/architecture/backend.md b/docs/technical-guide/developer/architecture/backend.md
index 1fd2ab2a70..eb0517e9eb 100644
--- a/docs/technical-guide/developer/architecture/backend.md
+++ b/docs/technical-guide/developer/architecture/backend.md
@@ -1,5 +1,6 @@
---
title: Backend app
+desc: Dive into self-hosting, configuration, developer insights (architecture, data model), integration, and troubleshooting. See Penpot's Technical Guide.
---
# Backend app
diff --git a/docs/technical-guide/developer/architecture/common.md b/docs/technical-guide/developer/architecture/common.md
index c6f2c7a555..8cb3e38e91 100644
--- a/docs/technical-guide/developer/architecture/common.md
+++ b/docs/technical-guide/developer/architecture/common.md
@@ -1,5 +1,6 @@
---
title: Common code
+desc: Learn about architecture, data models, and development environments. See Penpot's technical guide for developers. Dive into common code.
---
# Common code
diff --git a/docs/technical-guide/developer/architecture/exporter.md b/docs/technical-guide/developer/architecture/exporter.md
index 1846fceeeb..c2547ab315 100644
--- a/docs/technical-guide/developer/architecture/exporter.md
+++ b/docs/technical-guide/developer/architecture/exporter.md
@@ -1,5 +1,6 @@
---
title: Exporter app
+desc: Learn about self-hosting, configuration, architecture (backend, frontend), data model, and development environment. See Penpot's technical guide.
---
# Exporter app
diff --git a/docs/technical-guide/developer/architecture/frontend.md b/docs/technical-guide/developer/architecture/frontend.md
index 33febe237c..c1caf3b4c8 100644
--- a/docs/technical-guide/developer/architecture/frontend.md
+++ b/docs/technical-guide/developer/architecture/frontend.md
@@ -1,5 +1,6 @@
---
title: Frontend app
+desc: Dive into the UI, data namespaces, ClojureScript, React, and worker app functionalities. View Penpot's frontend app architecture. Free to try!
---
### Frontend app
diff --git a/docs/technical-guide/developer/architecture/index.md b/docs/technical-guide/developer/architecture/index.md
index a4a5ed9150..1160393d9f 100644
--- a/docs/technical-guide/developer/architecture/index.md
+++ b/docs/technical-guide/developer/architecture/index.md
@@ -1,5 +1,6 @@
---
title: 3.01. Architecture
+desc: Dive into architecture, backend, frontend, data models, and development environments. Contribute and self-host for free! See Penpot's technical guide.
---
# Architecture
diff --git a/docs/technical-guide/developer/common.md b/docs/technical-guide/developer/common.md
index be8eacda23..ab2f51292e 100644
--- a/docs/technical-guide/developer/common.md
+++ b/docs/technical-guide/developer/common.md
@@ -1,5 +1,6 @@
---
title: 3.04. Common Guide
+desc: "View Penpot's technical guide: self-hosting, configuration, developer insights, architecture, data model, integration, and troubleshooting."
---
# Common guide
diff --git a/docs/technical-guide/developer/data-guide.md b/docs/technical-guide/developer/data-guide.md
index 8ab9f38496..793ff365ca 100644
--- a/docs/technical-guide/developer/data-guide.md
+++ b/docs/technical-guide/developer/data-guide.md
@@ -1,5 +1,6 @@
---
title: 3.08. Data Guide
+desc: Learn about data structures, code organization, file operations, migrations, shape editing, and component syncing. See Penpot's technical guide. Try it free!
---
# Data Guide
diff --git a/docs/technical-guide/developer/data-model/index.md b/docs/technical-guide/developer/data-model/index.md
index ffc6a13f7d..6d384825f4 100644
--- a/docs/technical-guide/developer/data-model/index.md
+++ b/docs/technical-guide/developer/data-model/index.md
@@ -1,5 +1,6 @@
---
title: 3.02. Data model
+desc: Learn about self-hosting, configuration, developer tools, data models, architecture, and integrations. View Penpot's technical guide. Free to use!
---
# Penpot Data Model
diff --git a/docs/technical-guide/developer/devenv.md b/docs/technical-guide/developer/devenv.md
index fbec40c7ec..7e572c50fe 100644
--- a/docs/technical-guide/developer/devenv.md
+++ b/docs/technical-guide/developer/devenv.md
@@ -1,5 +1,6 @@
---
title: 3.03. Dev environment
+desc: Dive into Penpot's development environment. Learn about self-hosting, configuration, developer tools, architecture, and more. See the Penpot Technical Guide!
---
# Development environment
diff --git a/docs/technical-guide/developer/frontend.md b/docs/technical-guide/developer/frontend.md
index 1f24b58d24..bbab7a6eb2 100644
--- a/docs/technical-guide/developer/frontend.md
+++ b/docs/technical-guide/developer/frontend.md
@@ -1,5 +1,6 @@
---
title: 3.05. Frontend Guide
+desc: "See Penpot's technical guide: self-hosting, configuration, developer insights (architecture, data model), frontend, backend, and integrations & more!"
---
# Frontend Guide
diff --git a/docs/technical-guide/developer/index.md b/docs/technical-guide/developer/index.md
index 1e635f5592..d15dbf9939 100644
--- a/docs/technical-guide/developer/index.md
+++ b/docs/technical-guide/developer/index.md
@@ -1,5 +1,6 @@
---
title: 3. Developer Guide
+desc: Dive into architecture, data models, and more. Start building today! See Penpot's technical guide for self-hosting, configuration, and developer insights.
---
# Developer Guide
diff --git a/docs/technical-guide/developer/subsystems/assets-storage.md b/docs/technical-guide/developer/subsystems/assets-storage.md
index 62000d5a81..7108670c5a 100644
--- a/docs/technical-guide/developer/subsystems/assets-storage.md
+++ b/docs/technical-guide/developer/subsystems/assets-storage.md
@@ -1,5 +1,6 @@
---
title: Assets storage
+desc: Learn about assets storage, API, object buckets, sharing, and garbage collection. See Penpot's technical guide for developers. Try Penpot - It's free.
---
# Assets storage
diff --git a/docs/technical-guide/developer/subsystems/authentication.md b/docs/technical-guide/developer/subsystems/authentication.md
index 97fa3a9e4e..da437194ee 100644
--- a/docs/technical-guide/developer/subsystems/authentication.md
+++ b/docs/technical-guide/developer/subsystems/authentication.md
@@ -1,5 +1,6 @@
---
title: Authentication
+desc: Dive into Penpot today! Learn about self-hosting, configuration, developer insights, authentication, and more. View Penpot's technical guide. Try it free.
---
# User authentication
diff --git a/docs/technical-guide/developer/subsystems/index.md b/docs/technical-guide/developer/subsystems/index.md
index 71dfb51c8b..f53b59adbf 100644
--- a/docs/technical-guide/developer/subsystems/index.md
+++ b/docs/technical-guide/developer/subsystems/index.md
@@ -1,5 +1,6 @@
---
title: 3.09. Penpot subsystems
+desc: Learn about architecture, data models, and subsystems. View Penpot's technical guide for self-hosting, configuration, and development insights. Free!
---
# Penpot subsystems
@@ -12,4 +13,3 @@ implemented, over the whole app (backend, frontend or exporter), and points to
the most relevant source files to look at to start exploring it. When some
special considerations are needed (performance questions, limits, common
"gotchas", historic reasons of some decisions, etc.) they are also noted.
-
diff --git a/docs/technical-guide/developer/ui.md b/docs/technical-guide/developer/ui.md
index a646bd3d2e..5105e2bc52 100644
--- a/docs/technical-guide/developer/ui.md
+++ b/docs/technical-guide/developer/ui.md
@@ -1,5 +1,6 @@
---
title: 3.10. UI Guide
+desc: Learn UI development with React & Rumext, design system implementation, and performance considerations. See Penpot's technical guide. Free to use!
---
# UI Guide
diff --git a/docs/technical-guide/getting-started/docker.md b/docs/technical-guide/getting-started/docker.md
index 9832623b67..5608c6882d 100644
--- a/docs/technical-guide/getting-started/docker.md
+++ b/docs/technical-guide/getting-started/docker.md
@@ -1,5 +1,6 @@
---
title: 1.3 Install with Docker
+desc: This Penpot technical guide covers self-hosting, Docker installation, configuration, updates, backups, and proxy setup with NGINX and Caddy. Try Penpot!
---
diff --git a/docs/technical-guide/getting-started/index.md b/docs/technical-guide/getting-started/index.md
index bdf6812cb5..175cf99195 100644
--- a/docs/technical-guide/getting-started/index.md
+++ b/docs/technical-guide/getting-started/index.md
@@ -1,5 +1,6 @@
---
title: 1. Self-hosting Guide
+desc: Customize your Penpot instance today. Learn how to install with Elestio, Docker, or Kubernetes from the technical guide for self-hosting options.
---
# Self-hosting Guide
diff --git a/docs/technical-guide/getting-started/kubernetes.md b/docs/technical-guide/getting-started/kubernetes.md
index ccfe79a5c9..d2e9f969d9 100644
--- a/docs/technical-guide/getting-started/kubernetes.md
+++ b/docs/technical-guide/getting-started/kubernetes.md
@@ -1,5 +1,6 @@
---
title: 1.4 Install with Kubernetes
+desc: Learn how to install and configure Penpot on your Kubernetes cluster using Helm. Our technical guide provides step-by-step instructions for setup.
---
# Install with Kubernetes
diff --git a/docs/technical-guide/getting-started/recommended-settings.md b/docs/technical-guide/getting-started/recommended-settings.md
index 0993b22341..1fc93e06a7 100644
--- a/docs/technical-guide/getting-started/recommended-settings.md
+++ b/docs/technical-guide/getting-started/recommended-settings.md
@@ -1,5 +1,6 @@
---
title: 1.1 Recommended storage
+desc: Learn recommended self-hosting settings, Docker & Kubernetes installs, configuration, and troubleshooting tips in Penpot's technical guide.
---
# Recommended storage
diff --git a/docs/technical-guide/getting-started/unofficial-options.md b/docs/technical-guide/getting-started/unofficial-options.md
index 24f05f2a7e..66692e6765 100644
--- a/docs/technical-guide/getting-started/unofficial-options.md
+++ b/docs/technical-guide/getting-started/unofficial-options.md
@@ -1,5 +1,6 @@
---
title: 1.5 Unofficial self-host options
+desc: Find guides for Docker, Kubernetes, and more in Penpot's Technical Guide for self-hosting options! Discover unofficial self-host options too.
---
# Unofficial self-host options
diff --git a/docs/technical-guide/index.md b/docs/technical-guide/index.md
index 8f0b2783ad..934734bd5e 100644
--- a/docs/technical-guide/index.md
+++ b/docs/technical-guide/index.md
@@ -1,5 +1,6 @@
---
title: Technical Guide
+desc: Get self-hosting instructions, integration details, and developer resources. Troubleshoot issues easily. Try Penpot free! See Penpot's technical guide.
eleventyNavigation:
key: Technical Guide
order: 4
diff --git a/docs/technical-guide/integration.md b/docs/technical-guide/integration.md
index a58cab66fa..2d8d1c5a0a 100644
--- a/docs/technical-guide/integration.md
+++ b/docs/technical-guide/integration.md
@@ -1,5 +1,6 @@
---
title: 4. Integration Guide
+desc: Connect Penpot with other apps using webhooks and access tokens! Learn from Penpot's integration guide for seamless workflows. Try Penpot - It's free.
---
# Integration Guide
diff --git a/docs/technical-guide/troubleshooting.md b/docs/technical-guide/troubleshooting.md
index 56274258bb..f3e2028b07 100644
--- a/docs/technical-guide/troubleshooting.md
+++ b/docs/technical-guide/troubleshooting.md
@@ -1,5 +1,6 @@
---
title: 5. Troubleshooting Penpot
+desc: Troubleshoot Penpot like a pro! Our technical guide offers tips and tricks for diagnosing issues, reading logs, and resolving problems. Get started now!
---
# Troubleshooting Penpot
diff --git a/docs/user-guide/components/index.njk b/docs/user-guide/components/index.njk
index 44893da64d..6aa8ba78c6 100644
--- a/docs/user-guide/components/index.njk
+++ b/docs/user-guide/components/index.njk
@@ -1,10 +1,11 @@
---
title: 11· Components
+desc: Streamline your design workflow with Penpot's Components guide! Learn to create, duplicate, group, and manage reusable components.
---
Components
Speed your workflow with the reusable power of components.
-
A component is an object or group of objects that can be reused multiple times across files. This can help you maintain consistency across a group of designs.
+
A component is an object or group of objects that can be reused multiple times across files. This can help you maintain consistency across a group of designs.
A component has two parts:
@@ -62,7 +63,7 @@ title: 11· Components
Group components
Create component groups
-
At the Components section from the Assets library, there are two ways to create groups in a components library.
+
At the Components section from the Assets library, there are two ways to create groups in a components library.
Using slashes (/): Select one component and rename it as follows: "FOLDER NAME/COMPONENT NAME". For example, "Buttons/Alert Button".
Using the "Group" option: Select one or more components at the Assets library, right click to show the menu and then select "Group".
diff --git a/docs/user-guide/custom-fonts/index.njk b/docs/user-guide/custom-fonts/index.njk
index 096ab313dd..d3436b62d7 100644
--- a/docs/user-guide/custom-fonts/index.njk
+++ b/docs/user-guide/custom-fonts/index.njk
@@ -1,5 +1,6 @@
---
title: 17· Custom fonts
+desc: Penpot's guide on custom fonts! Upload, manage, and use custom fonts in Penpot! Enhance your designs with personalised typography.
---
Custom fonts
@@ -13,9 +14,9 @@ title: 17· Custom fonts
To upload a local font:
Press “Add custom font”.
-
Inspect your local files to select one or more fonts that you want to upload. You can upload fonts with
+
Inspect your local files to select one or more fonts that you want to upload. You can upload fonts with
the following formats: TTF, OTF and WOFF. Only one format will be needed.
-
Change the font name if needed. The font name is the name that will be shown in the font list at the workspace.
+
Change the font name if needed. The font name is the name that will be shown in the font list at the workspace.
It is also what Penpot uses to group fonts in families. You can always edit it later.
Once ready, press upload. That's it. The font will be available at the font list of this team’s files.
diff --git a/docs/user-guide/exporting/index.njk b/docs/user-guide/exporting/index.njk
index d685a66834..d0272a9c54 100644
--- a/docs/user-guide/exporting/index.njk
+++ b/docs/user-guide/exporting/index.njk
@@ -1,5 +1,6 @@
---
title: 07· Exporting objects
+desc: Learn how to export objects in Penpot, the free, open-source design collaboration tool. This guide covers export presets, file formats, and more!
---
Exporting objects
diff --git a/docs/user-guide/flexible-layouts/index.njk b/docs/user-guide/flexible-layouts/index.njk
index b1290b7804..af497b9d7b 100644
--- a/docs/user-guide/flexible-layouts/index.njk
+++ b/docs/user-guide/flexible-layouts/index.njk
@@ -1,5 +1,6 @@
---
title: 08· Flexible Layouts
+desc: Master responsive web design with Penpot's flexible and grid layouts! Learn Flexbox and CSS Grid standards. Explore tutorials, properties, and more.
---
Flexible Layouts
diff --git a/docs/user-guide/import-export/index.njk b/docs/user-guide/import-export/index.njk
index 7aa9cb4f3f..d12f84e133 100644
--- a/docs/user-guide/import-export/index.njk
+++ b/docs/user-guide/import-export/index.njk
@@ -1,5 +1,6 @@
---
title: 15· Import/export files
+desc: Learn how to import and export files in Penpot, the free, open-source design tool. Discover file formats, backups, sharing, and library management.
---
Import and export files
diff --git a/docs/user-guide/index.njk b/docs/user-guide/index.njk
index 06f362297b..bafce3954b 100644
--- a/docs/user-guide/index.njk
+++ b/docs/user-guide/index.njk
@@ -1,5 +1,6 @@
---
title: User guide
+desc: Learn everything from interface basics to advanced features like prototyping and design sharing with Penpot's comprehensive user guide! Free access.
eleventyNavigation:
key: User guide
order: 2
diff --git a/docs/user-guide/inspect/index.njk b/docs/user-guide/inspect/index.njk
index 869429287d..6aa2951262 100644
--- a/docs/user-guide/inspect/index.njk
+++ b/docs/user-guide/inspect/index.njk
@@ -1,5 +1,6 @@
---
title: 14· Inspect designs
+desc: Learn how to inspect designs in Penpot! This guide covers distances, properties, code snippets (CSS, SVG, HTML), & exporting assets for seamless collaboration.
---
Inspect designs
diff --git a/docs/user-guide/introduction/index.njk b/docs/user-guide/introduction/index.njk
index d38e35b01b..858d088576 100644
--- a/docs/user-guide/introduction/index.njk
+++ b/docs/user-guide/introduction/index.njk
@@ -1,5 +1,6 @@
---
title: 01· Introduction
+desc: Begin with the Penpot user guide! Get quickstarts, shortcuts, and tutorials. Learn the interface, layers, objects, styling, and more.
---
Introduction
diff --git a/docs/user-guide/introduction/info.njk b/docs/user-guide/introduction/info.njk
index 5c4cb852e2..cd5868edc4 100644
--- a/docs/user-guide/introduction/info.njk
+++ b/docs/user-guide/introduction/info.njk
@@ -1,5 +1,6 @@
---
title: Tutorials & info
+desc: Begin with Penpot's comprehensive user guide! Get tutorials, learn interface basics, and master design features. Discover FAQs and more.
---
Tutorials & info
diff --git a/docs/user-guide/introduction/quickstart.njk b/docs/user-guide/introduction/quickstart.njk
index 6b012d15ec..36aa2ae0f0 100644
--- a/docs/user-guide/introduction/quickstart.njk
+++ b/docs/user-guide/introduction/quickstart.njk
@@ -1,5 +1,6 @@
---
title: Quickstart
+desc: Start instantly with Penpot, the open-source design and prototyping platform! Access our free user guide to learn now.
---
Quickstart
diff --git a/docs/user-guide/introduction/shortcuts.njk b/docs/user-guide/introduction/shortcuts.njk
index 0949dc2525..00fdadf777 100644
--- a/docs/user-guide/introduction/shortcuts.njk
+++ b/docs/user-guide/introduction/shortcuts.njk
@@ -1,5 +1,6 @@
---
title: Shortcuts
+desc: Get quickstart tips, shortcuts, and tutorials for Penpot! Learn interface basics and more with this free, open-source design tool.
---
Shortcuts
diff --git a/docs/user-guide/layer-basics/index.njk b/docs/user-guide/layer-basics/index.njk
index 7888396c3d..ff17a77738 100644
--- a/docs/user-guide/layer-basics/index.njk
+++ b/docs/user-guide/layer-basics/index.njk
@@ -1,5 +1,6 @@
---
title: 04· Layer basics
+desc: Master layer basics with Penpot's user guide! Learn to create, manipulate, and organize layers for stunning designs. Try Penpot, it's free!
---
Layer basics
diff --git a/docs/user-guide/libraries/index.njk b/docs/user-guide/libraries/index.njk
index f821ff1da3..84967f445a 100644
--- a/docs/user-guide/libraries/index.njk
+++ b/docs/user-guide/libraries/index.njk
@@ -1,5 +1,6 @@
---
title: 09· Asset Libraries
+desc: Use Penpot's asset libraries for reusable design elements! Learn to create, manage, and share components, colors, and typography. Try Penpot - it's free!
---
Asset Libraries
@@ -112,7 +113,7 @@ title: 09· Asset Libraries
Group assets
-
There are two ways to create groups in a library.
+
There are two ways to create groups in a library.
With slashes (/): Select an asset and rename it as follows: "FOLDER NAME/ASSET NAME". For example, "Buttons/Alert Button".
With the "Group" option: Select one or more assets at the library, then right click to show the menu and then select "Group".
@@ -138,7 +139,7 @@ title: 09· Asset Libraries
Libraries
File libraries
-
Each file has its own file library which is where the assets that belong to this file are stored.
+
Each file has its own file library which is where the assets that belong to this file are stored.
You have two ways to access the file library from the file workspace:
Click the assets tab icon at the left sidebar.
diff --git a/docs/user-guide/objects/index.njk b/docs/user-guide/objects/index.njk
index 35b8e9f39a..5faba1e1ca 100644
--- a/docs/user-guide/objects/index.njk
+++ b/docs/user-guide/objects/index.njk
@@ -1,5 +1,6 @@
---
title: 05· Objects
+desc: "Work with Penpot's objects: boards, shapes, text, paths, and graphics. Learn to create, select, rename, and customize boards for optimal workflow."
---
Objects
@@ -7,7 +8,7 @@ title: 05· Objects
available in Penpot, and how to get the most of them.
Boards
-
A Board is a layer typically used as a container for a design. Boards are useful if you want to design for a specific screen or print size. Boards can contain other boards. First level boards
+
A Board is a layer typically used as a container for a design. Boards are useful if you want to design for a specific screen or print size. Boards can contain other boards. First level boards
are shown by default at the View mode, acting as screens of a design or pages of a document. Also, objects inside boards can be clipped. Boards are a powerful element at Penpot, opening up a ton of possibilities when creating and organizing your designs.
Create boards
@@ -80,7 +81,7 @@ are shown by default at the View mode, actin
Show in View mode
-
Boards offer the option to be shown as a separate board/screen in the View mode. Use this setting to decide what boards should be shown as individual items in your presentations.
+
Boards offer the option to be shown as a separate board/screen in the View mode. Use this setting to decide what boards should be shown as individual items in your presentations.
Defaults
As it is very likely that the first level boards will be used as a screen and the interiors will not, there are different defaults for newly created boards.
diff --git a/docs/user-guide/plugins/index.njk b/docs/user-guide/plugins/index.njk
index 8916145b6e..fd7e4ca0a3 100644
--- a/docs/user-guide/plugins/index.njk
+++ b/docs/user-guide/plugins/index.njk
@@ -1,5 +1,6 @@
---
title: 18· Plugins
+desc: Extend Penpot's functionality with plugins! Install from PenpotHub or via URL. Learn to install, use, and create your own plugins.
---
Penpot Plugins
diff --git a/docs/user-guide/prototyping/index.njk b/docs/user-guide/prototyping/index.njk
index 388f9b2d1b..c329d867ef 100644
--- a/docs/user-guide/prototyping/index.njk
+++ b/docs/user-guide/prototyping/index.njk
@@ -1,5 +1,6 @@
---
title: 12· Prototyping
+desc: This Penpot user guide explains how to prototype interactions, connect boards, use triggers/actions, and animations. Learn to build flows and more!
---
Prototyping interactions
diff --git a/docs/user-guide/styling/index.njk b/docs/user-guide/styling/index.njk
index 47b3d9df82..8f8ed0a57a 100644
--- a/docs/user-guide/styling/index.njk
+++ b/docs/user-guide/styling/index.njk
@@ -1,13 +1,14 @@
---
title: 06· Styling
+desc: Style your designs with Penpot's options! Learn about color fills, gradients, strokes, shadows, blur, opacity, blend modes, and property copying.
---
Styling
Penpot has a variety of styling options for each object. When selected, the styling options are displayed in the design panel on the right.
Color fills
-
Color fills can be added to boards, shapes, texts and groups of layers.
-
You can add as fills:
+
Color fills can be added to boards, shapes, texts and groups of layers.
Set the overal opacity for layers and their blend mode.
+
Set the overal opacity for layers and their blend mode.
Blend allows you to control how a layer interacts with the layers beneath it, determining how pixels from the current layer are combined with pixels in the underlying layers. Use blend to achive various effects, such as shading, highlights, or creative visual styles.
@@ -195,7 +196,7 @@ title: 06· Styling
Copy/Paste properties
-
You can copy and apply properties, including fills, strokes, shadows, and others from one layer to another—or multiple layers with just a few clicks. You can do it using the layer's menu or shortcuts.
+
You can copy and apply properties, including fills, strokes, shadows, and others from one layer to another—or multiple layers with just a few clicks. You can do it using the layer's menu or shortcuts.