diff --git a/cypress/integration/site-search/index.spec.ts b/cypress/integration/site-search/index.spec.ts index 62e6b558c6..17074c8a6a 100644 --- a/cypress/integration/site-search/index.spec.ts +++ b/cypress/integration/site-search/index.spec.ts @@ -21,7 +21,5 @@ describe("Docs website search", () => { .type("{enter}"); cy.wait("@searchRequest"); cy.get('[data-cy="paste-docsearch-hits"] h2').should("have.length.above", 0); - cy.get('[data-cy="paste-docsearch-hits"] ul').should("have.length.above", 0); - cy.get('[data-cy="paste-docsearch-hits"] li').should("have.length.above", 0); }); }); diff --git a/cypress/integration/sitemap-vrt/constants.ts b/cypress/integration/sitemap-vrt/constants.ts index 3c1c12518f..151730c856 100644 --- a/cypress/integration/sitemap-vrt/constants.ts +++ b/cypress/integration/sitemap-vrt/constants.ts @@ -20,6 +20,7 @@ export const SITEMAP = [ "/blog/2023-08-01-bringing-cohesion-to-the-twilio-product-suite-part-ii/", "/blog/2023-08-02-paste-newsletter/", "/blog/2023-11-08-paste-newsletter/", + "/blog/2024-02-06-paste-2023-year-in-review/", "/components/account-switcher/", "/components/account-switcher/api", "/components/account-switcher/changelog", diff --git a/packages/paste-website/src/assets/images/articles/2023-year-review/docs.png b/packages/paste-website/src/assets/images/articles/2023-year-review/docs.png new file mode 100644 index 0000000000..f43c4cd863 Binary files /dev/null and b/packages/paste-website/src/assets/images/articles/2023-year-review/docs.png differ diff --git a/packages/paste-website/src/assets/images/articles/2023-year-review/form.png b/packages/paste-website/src/assets/images/articles/2023-year-review/form.png new file mode 100644 index 0000000000..9b0f3bea17 Binary files /dev/null and b/packages/paste-website/src/assets/images/articles/2023-year-review/form.png differ diff --git a/packages/paste-website/src/assets/images/articles/2023-year-review/language.png b/packages/paste-website/src/assets/images/articles/2023-year-review/language.png new file mode 100644 index 0000000000..b0561b6bf0 Binary files /dev/null and b/packages/paste-website/src/assets/images/articles/2023-year-review/language.png differ diff --git a/packages/paste-website/src/assets/images/articles/2023-year-review/layout.png b/packages/paste-website/src/assets/images/articles/2023-year-review/layout.png new file mode 100644 index 0000000000..67b7830254 Binary files /dev/null and b/packages/paste-website/src/assets/images/articles/2023-year-review/layout.png differ diff --git a/packages/paste-website/src/assets/images/articles/2023-year-review/numbers.png b/packages/paste-website/src/assets/images/articles/2023-year-review/numbers.png new file mode 100644 index 0000000000..b0c9abcb2c Binary files /dev/null and b/packages/paste-website/src/assets/images/articles/2023-year-review/numbers.png differ diff --git a/packages/paste-website/src/assets/images/articles/2023-year-review/tabsandstuff.png b/packages/paste-website/src/assets/images/articles/2023-year-review/tabsandstuff.png new file mode 100644 index 0000000000..6f44ebe162 Binary files /dev/null and b/packages/paste-website/src/assets/images/articles/2023-year-review/tabsandstuff.png differ diff --git a/packages/paste-website/src/assets/images/articles/2023-year-review/templates.png b/packages/paste-website/src/assets/images/articles/2023-year-review/templates.png new file mode 100644 index 0000000000..3442a9581f Binary files /dev/null and b/packages/paste-website/src/assets/images/articles/2023-year-review/templates.png differ diff --git a/packages/paste-website/src/assets/images/articles/2023-year-review/theme.png b/packages/paste-website/src/assets/images/articles/2023-year-review/theme.png new file mode 100644 index 0000000000..34185341a5 Binary files /dev/null and b/packages/paste-website/src/assets/images/articles/2023-year-review/theme.png differ diff --git a/packages/paste-website/src/assets/images/articles/2023-year-review/type.png b/packages/paste-website/src/assets/images/articles/2023-year-review/type.png new file mode 100644 index 0000000000..50cbc8c6fd Binary files /dev/null and b/packages/paste-website/src/assets/images/articles/2023-year-review/type.png differ diff --git a/packages/paste-website/src/pages/blog/2024-02-06-paste-2023-year-in-review.mdx b/packages/paste-website/src/pages/blog/2024-02-06-paste-2023-year-in-review.mdx new file mode 100644 index 0000000000..5eebccd365 --- /dev/null +++ b/packages/paste-website/src/pages/blog/2024-02-06-paste-2023-year-in-review.mdx @@ -0,0 +1,233 @@ +export const meta = { + title: '2023 - A year in review', + slug: '/blog/2024-02-06-paste-2023-year-in-review/', + date: '2024-02-06', + author: 'Simon Taggart', + avatar: 'https://avatars.githubusercontent.com/u/368249', + excerpt: 'With the year 2023 wrapped up, we want to take a moment to hoot our own horn and look back at the remarkable achievements the Paste team has accomplished. ', +}; + +import Image from 'next/image'; +import {Paragraph} from '@twilio-paste/paragraph'; +import {Box} from '@twilio-paste/box'; +import {Text} from '@twilio-paste/text'; +import {Anchor} from '@twilio-paste/anchor'; +import {Callout, CalloutHeading, CalloutText} from '@twilio-paste/callout'; + +import {ResponsiveImage} from '../../components/ResponsiveImage'; + +import NavUIKit from '../../assets/images/articles/2023-06-12-paste-newsletter/nav-ui-kit.png'; +import Pastebot from '../../assets/images/articles/2023-11-08-paste-newsletter/Pastebot.png'; +import Docs from '../../assets/images/articles/2023-year-review/docs.png'; +import Form from '../../assets/images/articles/2023-year-review/form.png'; +import Language from '../../assets/images/articles/2023-year-review/language.png'; +import Layout from '../../assets/images/articles/2023-year-review/layout.png'; +import Numbers from '../../assets/images/articles/2023-year-review/numbers.png'; +import TabsAndStuff from '../../assets/images/articles/2023-year-review/tabsandstuff.png'; +import Templates from '../../assets/images/articles/2023-year-review/templates.png'; +import Theme from '../../assets/images/articles/2023-year-review/theme.png'; +import Typography from '../../assets/images/articles/2023-year-review/type.png'; + +import DefaultLayout from '../../layouts/DefaultLayout'; +import {getNavigationData} from '../../utils/api'; + +export default DefaultLayout; + +export const getStaticProps = async () => { + const navigationData = await getNavigationData(); + return { + props: { + navigationData, + }, + }; +}; + + + +--- + + + + + + + +With the year 2023 wrapped up, we want to take a moment to hoot our own horn and look back at the remarkable achievements we made as a team. Through dedication and a collaborative spirit, we've launched innovative initiatives, new components, design languages, and cohesive UI kits that have significantly elevated the user experience across Twilio products. This review celebrates the fruits of our labor, spotlighting each component, guideline, and enhancement that has shaped the foundation of our seamless and unified design system. + +## 💅 One Twilio Design Language + + + +2023 marked the release of the One Twilio Design Language (Read about it on the [Twilio Blog](https://www.twilio.com/blog/bringing-cohesion-to-the-twilio-product-suite-part-i) —a milestone in the unification across all of Twilio's platforms. This design language harmonizes visual elements and interactive components under a set of themes, namely twilio and twilio-dark, which are meticulously crafted to cater to a broad spectrum of interface applications and user preferences. The Evergreen theme was released to aid Segment's migration to the Twilio Design Language, by providing an evolutionary architecture tool to incrementally replace Evergreen without stopping feature development or customer impact. + +## 🧭 Navigation UI Kit + + + +The [Navigation UI Kit](https://www.twilio.com/blog/bringing-cohesion-to-the-twilio-product-suite-part-ii), introduced in August, solidified our commitment to a unified user interface. By providing the building blocks to support every application's navigation needs, we created a cohesive and familiar navigation experience as customers as they switch between Twilio products. The new components that were created as part of the Navigation UI Kit are: + +- **[Topbar](/components/topbar)**: Serves as a centralized access point for application controls, segmenting into User and Account controls. +- **[Sidebar](/components/sidebar#compact-overlay-sidebar)**: Functions primarily for application navigation, with flexible modes. +- **[Account Switcher](/components/account-switcher)**: Standardizes transitions between accounts or related entities within any Twilio application. +- **[Product Switcher](/components/product-switcher)**: Simplifies transitions between Twilio services. +- **[User Dialog](/components/user-dialog)**: Offers convenient access to account-related settings and preferences. +- **[Status Badge](/components/status-badge) and [Status Menu](/components/status-menu)**: Provide visual indicators for processes or connection statuses. + +## 🛳️ Where we're seeing it + + + +Since its release we're already seeing the new design language and navigation rollout to several customer touch points, across [Universal Login](https://login.twilio.com/u/signup), the new [One Support Center](https://help.twilio.com/), the new [Twilio Docs Platform](https://www.twilio.com/docs/global-infrastructure) and new internal tools. We also saw the **[Product Switcher](/components/product-switcher)** get implemented this year to provide super easy navigation between Twilio products. + + + 💡 Did you know? + + From 0% adoption 4 years ago, we now see that 80% of all Twilio Console page views are pages built entirely with Paste. Segment went from 0% to 48% Paste adoption in 9 months! + + + This makes it so easy to roll out our unified Design Language to the rest of Twilio customers in 2024. With such high adoption, we're so close! + + + +

+ +## 📈 2023 in numbers + +In addition to those two large projects, the team managed to ship: + +| Components | Primitives | Icons | Patterns | Templates | Foundations | +|------------|------------|-------|----------|-----------|-------------| +| 18 | 1 | 75 | 2 | 4 | 2 | + +### Paste in Code + +We continue to see exceptional adoption of components to build out Twilio UIs across the business, here's a highlight of what we're seeing (numbers represent each time a react component is used): + +| Console | Internal tools | Segment App | Sendgrid App | Overall Total | +|---------|----------------|-------------|--------------|---------------| +| ~55,314 | ~13,955 | 12,966 | 2,137 | ~85,469 | + +## 📝 Typography and Page Layout Guidelines + +### [Typography Guidelines](/foundations/typography) + + + +The Typography Guidelines set specific parameters for the use of the new typefaces—Twilio Sans Display, Twilio Sans Text, and Twilio Sans Mono—ensuring consistent readability and visual harmony across Twilio's product landscapes. + +### [Page Spacing and Layout Guidelines](/foundations/spacing-and-layout) + + + +Launched in January, these guidelines provide foundational advice on creating visual relationships between page elements, thus aiding product builders to craft intuitive and visually coherent interfaces. + +## 👩‍💻 Form and Functional Components + +### [Form Component](/components/form) + + + +The Form component standardizes form interfaces across different pages, making usability and user interaction uniform and intuitive. + +### [File Uploader](/components/file-uploader) + +Addressing the frequent need for file attachments, the File Uploader is made easily accessible and user-friendly with drag-and-drop functionalities. + +### [Editable Code Block Component](/components/editable-code-block) + +The Editable Code Block Component, based on the Paste Code Editor library, allows for essential code-editing functionalities within web applications. + +## ⚖️ Numerical Components + +### Slider, Number Input, Progress Bar, and Meter + + + +Four new components emerged to depict numerical data effectively: + +- [The Slider](/components/slider) allows for precise control over a range of values. +- [The Number Input](/components/input#input-with-number-functionality) provides a dedicated interface for numerical entry. +- [The Progress Bar](/components/account-switcher) visualizes progress through processes. +- [The Meter](/components/product-switcher) is used where capacity or quantity needs to be displayed in a range. + +## 🚧 Context, Progress, and Refreshed Components + + + +### [Description List Component](/components/description-list) + +The Description List Component was designed to present information methodically, managing dense text effectively to extract pertinent details without the clutter. + +### [Detail Text Component](/components/detail-text) + +April saw the introduction of the Detail Text Component intended for subtly accompanying main content without overpowering it. + +### [Progress Steps Component](/components/progress-steps) + +The Progress Steps Component, which debuted in August, addresses the challenge of guiding users through multi-step tasks or sessions with a visual tracking system. + +### [Refreshed Avatar Component and New Avatar Group](/components/avatar) + +A significant refresh was done for the Avatar component to permit the display of groups. This functionality is vital for Twilio products that handle entity or human group representations. + +### [Redesigned Tabs Component](/components/tabs) + +To delineate tabs from in-page navigation more distinctly, the Tabs component was redesigned to reflect its functionality more clearly. + +## 🎨 Patterns, Templates, and Documentation + +### [Launch of Page Templates](/page-templates) + + + +November saw the launch of a series of page templates. These include settings for various page types ranging from object details to wizards. These templates offer flexible layout choices to cater to product and platform-agnostic needs. + +### [Error Messaging Content Guidelines](/patterns/error-state) + +Through Megan Allison's contribution, the Error State pattern documentation was formulated, presenting a structured approach for creating precise error messages. + +### Documentation Reorganization + + + +Component documentation underwent a transformation: + +- **Guidelines Page:** Offers comprehensive usage instructions. +- **API Page:** Provides detailed technical properties, all now automated to ensure accuracy. +- **Changelog Page:** Keeps a record of component updates and changes. + +### [Confirmation Pattern](/patterns/confirmation) + +An addition from Megan Allison, the Confirmation Pattern aids in presenting complex or consequential actions to users in a clear manner. + +## 🧑‍🔧 Infrastructure and Automation + +### Automated Monorepo Dependency Management + +By automating monorepo dependency management and ensuring full support for React 18, we've secured a robust foundation for Paste going forward. + +### CI Runtime Reduction + +Efforts to reduce average Continuous Integration runtime paid off, reducing some long running task by 75%. + +### PasteBot and AI + + + +We started experimenting with AI 2023, employing a ChatGPT powered Github Discussion answering bot that uses our documentation to try and provide a speedy answer to common, and known questions. + +## Closing Remarks + +As we kick off 2024, the Paste team is proud to highlight our comprehensive array of components, templates, and guidelines that were shipped in 2023. These latest achievements demonstrate our steadfast commitment to delivering exceptional experiences for developers and users alike. From boldly integrating AI with PasteBot to meticulously refining and updating key design elements, we've not only adapted to the evolving landscape – we've actively shaped it. In our pursuit of excellence, we continue to hone the tools and resources that empower creators and problem-solvers, fostering a dynamic ecosystem of innovation and collaboration. As we look ahead, we do so with renewed vigor and excitement for the next chapter in our journey. + + + + +