Skip to content

Instantly share code, notes, and snippets.

@mpaiva-cc
mpaiva-cc / clearco-product-glossary.md
Last active December 12, 2025 19:55
A guide to the words and terms used in ClearCompany. Find simple definitions, real-world examples, and helpful context for every feature across all product modules. Whether you're new to the platform or need a quick refresher, this glossary helps you understand the tools you use every day.

ClearCo Product Glossary

A guide to the words and terms used in ClearCo. Find simple definitions, real-world examples, and helpful context for every feature across all product modules. Whether you're new to the platform or need a quick refresher, this glossary helps you understand the tools you use every day.


How to Use This Glossary

@mpaiva-cc
mpaiva-cc / brainier-a11y-remedies.md
Created May 23, 2025 20:37
Brainier Accessibility Work Plan

Brainier Accessibility Work Plan

4-Week Friday Schedule

Friday 1: May 23, 2024

Focus: Semantic Headings & Navigation

Semantic Headings

@mpaiva-cc
mpaiva-cc / ui-patterns-list.md
Last active March 13, 2026 11:57
A curated list of SaaS UI workflow patterns used across modern B2B and B2C SaaS platforms.

Common SaaS Workflow Patterns

Note: The workflow patterns below are ordered by estimated usage frequency, based on navigation audit data and common SaaS conventions.

This document curates and describes common UI workflow patterns found in leading B2B and B2C SaaS platforms (e.g., Notion, Airtable, Figma, Asana, HubSpot, Linear).

Each pattern includes:

  • A clear flow description
  • Real-world examples
@mpaiva-cc
mpaiva-cc / voice-tone-language-label-guidelines.md
Last active May 21, 2025 22:12
Standards for all UI labels, helping teams create cohesive experiences within the Clear 3.0 design system.

ClearCompany Label Standardization Guidelines

Overview

These guidelines establish standards for all UI labels within ClearCompany's Clear 3.0 design system. Consistent labeling builds user trust, reduces cognitive load, and improves overall usability.

Accessibility & Inclusion

Standardized labels are fundamental to creating accessible, inclusive software for all users. These guidelines support:

@mpaiva-cc
mpaiva-cc / voice-tone-language-microcopy-examples.md
Last active May 19, 2025 21:21
Instructions and examples for writing clear, accessible content throughout ClearCompany products.

ClearCompany: Plain Language and Microcopy Guidelines

Introduction

This guide provides detailed instructions and examples for writing clear, accessible content throughout ClearCompany products. Following these standards ensures consistent communication and improved user experience for all users.


Plain Language Principles

@mpaiva-cc
mpaiva-cc / voice-tone-language-01.md
Last active November 13, 2025 00:40
This guide establishes the voice, tone, and language standards for ClearCompany's Clear 3.0 design system.

Clear 3.0: Voice, Tone, Language and Labeling Guidelines for Product Designers

Overview

These guidelines establish standards for all UI labels within a product's design system. Consistent labeling builds user trust, reduces cognitive load, and improves overall usability.

Accessibility & Inclusion

Standardized labels are fundamental to creating accessible, inclusive software for all users. These guidelines support:

@mpaiva-cc
mpaiva-cc / poc-selecting-design-system-template.md
Last active December 21, 2024 00:19
This template is designed to help teams systematically evaluate and compare open-source design systems to identify the best fit for ClearCompany’s needs.

Design System Assessment Summary Template

This template is designed to help teams systematically evaluate and compare open-source design systems to identify the best fit for ClearCompany’s needs. It provides a structured framework to assess critical features, such as component libraries, accessibility, design tokens, multi-framework compatibility, testing integrations, and documentation quality. By following this template, teams can ensure the selected design system aligns with the organization’s goals of scalability, usability, and long-term growth while supporting efficient onboarding and collaboration across design and engineering teams.


How to Use This Template

Step 1: Perform a Thorough Evaluation

Use the Thorough Evaluation Template to comprehensively assess each design system. The evaluation template helps engineers analyze key aspects of the system, including:

@mpaiva-cc
mpaiva-cc / poc-selecting-open-source-design-system.md
Last active December 21, 2024 00:01
This document serves as a structured guide for evaluating and selecting an open-source design system that meets ClearCompany's immediate needs and long-term objectives. It includes a detailed checklist of essential components, patterns, and advanced features required to build a scalable, accessible, and future-proof platform.

Template for Selecting an Open-Source Design System

This document serves as a structured guide for evaluating and selecting an open-source design system that meets ClearCompany's immediate needs and long-term objectives. It includes a detailed checklist of essential components, patterns, and advanced features required to build a scalable, accessible, and future-proof platform. By using this template, engineers and stakeholders can systematically assess potential design systems, ensuring the chosen solution accelerates development, supports enterprise functionality, and aligns with ClearCompany's goals for UpMarket growth.

Introduction

ClearCompany aims to adopt an open-source design system by the third week of January 2025 to accelerate development of the Learning Module (LMS) and support scalability for future UpMarket growth. The selected system must align with ClearCompany’s strategic goals while addressing the challenges of integrating with our legacy Backbone-based stack and enabl

@mpaiva-cc
mpaiva-cc / fed-onboarding.md
Last active December 19, 2024 16:42
Onboarding Frontend Develoeprs

Onboarding Checklist for Frontend Developers: Setting Up a Development Environment on a New Mac

Setting up a development environment on a new Mac is a crucial first step for frontend developers to ensure productivity and consistency in their workflows. This guide provides a comprehensive checklist for configuring your system with the essential tools and frameworks needed for modern web development.

From installing foundational software like Git and Node.js to setting up advanced tools like Docker and code editors, this step-by-step onboarding process is designed to get you up and running quickly.

Whether you’re a seasoned developer or just starting, following this guide will streamline your setup and help you focus on what matters most—writing great code!


@mpaiva-cc
mpaiva-cc / mfe-profile.md
Created December 19, 2024 12:53
Micro-frontend Engineer - Profile

Front-End Engineer – Next.js Multi-Zone Architecture

  • Location: Remote
  • Employment Type: Full-Time
  • Experience Level: Mid to Senior

About Us

We are building an innovative Human Capital Management (HCM) platform with a focus on scalability, accessibility, and cutting-edge architecture. Our mission is to redefine the user experience by integrating modern frameworks like Next.js with legacy systems such as Backbone.js, ensuring a seamless and accessible interface for all users.