-
@@ -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 b9e3ffa86..43f310788 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 619295579..2c9ef6b51 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 d6b0a74ca..b46ecd98e 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 ce99f3a0f..2c477f433 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 2b385f3e0..e424af52b 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 2d5bfae2b..da7b15a0c 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 f5b601f7f..66a57a322 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 e378b6a72..9abf6a9fa 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 599f2bb97..1f5823575 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 39736e239..80c4a08df 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 a225d0a58..d18616623 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 c5c1105f4..1836b132c 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 d883b39d6..405035859 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 89f42f61c..b2d2e5e9f 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 3390db4b3..63accb361 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 f944dbd45..7fac87c15 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 1fd2ab2a7..eb0517e9e 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 c6f2c7a55..8cb3e38e9 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 1846fceee..c2547ab31 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 33febe237..c1caf3b4c 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 a4a5ed915..1160393d9 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 be8eacda2..ab2f51292 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 8ab9f3849..793ff365c 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 ffc6a13f7..6d384825f 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 fbec40c7e..7e572c50f 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 1f24b58d2..bbab7a6eb 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 1e635f559..d15dbf993 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 62000d5a8..7108670c5 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 97fa3a9e4..da437194e 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 71dfb51c8..f53b59adb 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 a646bd3d2..5105e2bc5 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 9832623b6..5608c6882 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 bdf6812cb..175cf9919 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 ccfe79a5c..d2e9f969d 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 0993b2234..1fc93e06a 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 24f05f2a7..66692e676 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 8f0b2783a..934734bd5 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 a58cab66f..2d8d1c5a0 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 56274258b..f3e2028b0 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 44893da64..6aa8ba78c 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 096ab313d..d3436b62d 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 d685a6683..d0272a9c5 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 b1290b780..af497b9d7 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 7aa9cb4f3..d12f84e13 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 06f362297..bafce3954 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 869429287..6aa295126 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 d38e35b01..858d08857 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 5c4cb852e..cd5868edc 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 6b012d15e..36aa2ae0f 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 0949dc252..00fdadf77 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 7888396c3..ff17a7773 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 f821ff1da..84967f445 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 35b8e9f39..5faba1e1c 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 8916145b6..fd7e4ca0a 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 388f9b2d1..c329d867e 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 47b3d9df8..8f8ed0a57 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.