diff --git a/apps/docs/content/nav-groups/blog.md b/apps/docs/content/nav-groups/blog.md new file mode 100644 index 0000000000..66a1b281a4 --- /dev/null +++ b/apps/docs/content/nav-groups/blog.md @@ -0,0 +1,5 @@ +--- +permalink: false +title: Blog +parent: What's New +--- diff --git a/apps/docs/content/whats-new/blog/blog.11tydata.js b/apps/docs/content/whats-new/blog/blog.11tydata.js new file mode 100644 index 0000000000..7be9f76369 --- /dev/null +++ b/apps/docs/content/whats-new/blog/blog.11tydata.js @@ -0,0 +1,15 @@ +const slugify = require('slugify'); + +const permalink = (data) => + `/whats-new/${slugify(data.title, { lower: true })}/`; + +module.exports = { + parent: 'Blog', + eleventyComputed: { + permalink, + order: (data) => -parseInt(data.month.replace('-', '')), + eleventyNavigation: { + url: permalink, + }, + }, +}; diff --git a/apps/docs/content/whats-new/blog/vivid-live.md b/apps/docs/content/whats-new/blog/vivid-live.md new file mode 100644 index 0000000000..44563b5c2e --- /dev/null +++ b/apps/docs/content/whats-new/blog/vivid-live.md @@ -0,0 +1,139 @@ +--- +title: Figma - Vivid Live +month: 2025-01 +--- + +13th January 2025 + +# Introducing Vivid-Live: Figma Component Library + +We're thrilled to announce our new Figma component library – a significant upgrade to our previous design system that takes our Vivid components to the next level. If you've been using our existing library, get ready for a transformative design experience. + +## Why a New Library? + +Our previous Figma library served us well, but we knew we could do better. This new library isn't just an update – it's a complete reimagination of how design components should work. + +## What Has Changed In Vivid-Live Library? + +### Perfect Alignment with Our Vivid API + +Every component is now precisely synchronized with our Vivid API web components. What you design is exactly what developers will implement – eliminating any discrepancies between design and final product. + +### Advanced Figma Token Support + +We've fully embraced the latest Figma token features, providing: + +- Seamless dark and light mode implementations +- Consistent color management across design states +- Enhanced design flexibility + +### Improved Organization and Usability + +We've completely restructured the library to make: + +- Component selection more intuitive +- Navigation smoother and more logical +- Design workflow more efficient + +### Advanced Customization + +Full control through side panel options + +- Easily choose component appearances +- Toggle features on and off +- Set multiple component states with a few clicks +- Component description, extra explanation if needed and link to the docs page + +### Smart Compositions + +Pre-built, interconnected component setups + +- Expertly configured component combinations +- Examples include fully-configured select dropdowns with correct options +- Ready-to-use menu components with pre-populated menu items +- Intuitive connections between related components + +## Key Improvements + +- **Complete API Synchronization:** 100% alignment with Vivid API components +- **Thoroughly Tested:** We've gone the extra mile to make sure everything works perfectly ([Components QA](https://docs.google.com/spreadsheets/d/1-R6p9tJa6agJRDUkpfDNZ8kS4bXjfm7YcVZY4KoZAqg/edit?gid=0#gid=0)) +- **Expanded Component Set:** New components and enhanced features like: + + - Searchable select + - Video-player + - Side-Drawer + - Tabs - vertical tabs, removable tab + +- **Flexible Color Systems:** Full support for dark and light modes +- **Unparalleled Customization:** Granular control over component design + +## How to use Vivid-Live + +### #1 - adding the library + +[Vivid Live](https://www.figma.com/design/vDH2AytCxEvOulJ7olf9cS/Vivid-Live?node-id=0-1&p=f&t=UZaEYgO1lCigebt5-0) comes with 2 additional assets: + +- [Vivid Live Tokens](https://www.figma.com/design/l7PH4EhGm3SXH9FJQBBPZG/Vivid-Live-Tokens?node-id=33646-138859&t=AZY0LVVL7Qe15zCI-1) +- [Vivid Live Icons](https://www.figma.com/design/isdKI406usLCxZ2U8ljDrn/Vivid-Live-Icons?node-id=274-7267&t=YWWxn3L71PA9Hfuf-1) + +Make sure you are adding all 3 of them :) + +![adding vivid-live, live-tokens and live-icons](../../../../assets/images/blog-images/add-components.png) + +### #2 - adding components + +All components are ordered alphabetically. +Choose your component and add it. + +![component icons guide - OK for vivid QA, ! for designers QA](../../../../assets/images/blog-images/components-icon.png) + +### #3 - Dark / Light Theme + +Most of the components now are not declared as dark / light and can be configured under figma appearance section to meet your theme: + +![](../../../../assets/images/blog-images/dark-light-switch.png) + +However - when there’s drop-shadow - the tokens are not changing - so you’ll find a component for dark & light. + +![light-dart theme switcher](../../../../assets/images/blog-images/dark-and-light-variations.png) + +### #4 - Customize the components + +After adding the component - you’ll find all its options in the side panel. +From size to appearance to stats and text customization. + +![button component customization](../../../../assets/images/blog-images/customize-button.png) + +#### Known issues in customizing components + +- We did our best to keep the order of the properties reasonable and intuitive but using inner templates sometimes limited that option. +- We are using inner templates for component variation. + - Variation options are not always in the right order, although we did our best to keep the order of the properties reasonable and intuitive + - Some variations re-sets the component data. Make sure you pick the upper options before other customization. + ![nested and main component options](../../../../assets/images/blog-images/nested-options.png) +- In order to simplify and light components and for better maintenance we separated some components to different components. For example: + - **Button** has lots of variation - button basic, button basic transparent, stacked button and more: + ![buttons components](../../../../assets/images/blog-images/buttons-components.png) + - **Time Picker** (and same for all components with open drop-downs), we have a component for the input and a component that is composition of the input and a dropdown with the option set that fits for it. + ![time-picker](../../../../assets/images/blog-images/time-picker.png) + +### #5 - Slots + +Vivid-Live is synced to the API, which means, like the actual components, it uses Slots. +For each slot you can either show / hide the slot and swap the default slot with your content. + +![slot swap](../../../../assets/images/blog-images/slot-swap.png) + +### #6 - Composition + +Components like select, menu, tabs and more have a component that is built with composition. +You can configure the composition when entering the layer in the layers panel, you’ll see its options in the right panel. + +![composition-inside-components](../../../../assets/images/blog-images/composition-inside-components.png) + +## We're Listening + +This library is a living, breathing resource. We're committed to continuous improvement and value your feedback. +Spot something that could be even better? +We want to [hear from you](https://vonage.enterprise.slack.com/archives/G0169E0RF6K)! +❤ diff --git a/assets/images/blog-images/add-components.png b/assets/images/blog-images/add-components.png new file mode 100644 index 0000000000..0d034b67ba Binary files /dev/null and b/assets/images/blog-images/add-components.png differ diff --git a/assets/images/blog-images/buttons-components.png b/assets/images/blog-images/buttons-components.png new file mode 100644 index 0000000000..7ea7d8c36d Binary files /dev/null and b/assets/images/blog-images/buttons-components.png differ diff --git a/assets/images/blog-images/components-icon.png b/assets/images/blog-images/components-icon.png new file mode 100644 index 0000000000..44a87461c7 Binary files /dev/null and b/assets/images/blog-images/components-icon.png differ diff --git a/assets/images/blog-images/composition-inside-components.png b/assets/images/blog-images/composition-inside-components.png new file mode 100644 index 0000000000..c99f63e233 Binary files /dev/null and b/assets/images/blog-images/composition-inside-components.png differ diff --git a/assets/images/blog-images/customize-button.png b/assets/images/blog-images/customize-button.png new file mode 100644 index 0000000000..3fb36acea6 Binary files /dev/null and b/assets/images/blog-images/customize-button.png differ diff --git a/assets/images/blog-images/dark-and-light-variations.png b/assets/images/blog-images/dark-and-light-variations.png new file mode 100644 index 0000000000..71ef92154f Binary files /dev/null and b/assets/images/blog-images/dark-and-light-variations.png differ diff --git a/assets/images/blog-images/dark-light-switch.png b/assets/images/blog-images/dark-light-switch.png new file mode 100644 index 0000000000..52bae57df4 Binary files /dev/null and b/assets/images/blog-images/dark-light-switch.png differ diff --git a/assets/images/blog-images/nested-options.png b/assets/images/blog-images/nested-options.png new file mode 100644 index 0000000000..15a07f2b4f Binary files /dev/null and b/assets/images/blog-images/nested-options.png differ diff --git a/assets/images/blog-images/slot-swap.png b/assets/images/blog-images/slot-swap.png new file mode 100644 index 0000000000..05d5e0e767 Binary files /dev/null and b/assets/images/blog-images/slot-swap.png differ diff --git a/assets/images/blog-images/time-picker.png b/assets/images/blog-images/time-picker.png new file mode 100644 index 0000000000..c244c79bcb Binary files /dev/null and b/assets/images/blog-images/time-picker.png differ