Skip to content

Component Interface

Understanding the tabs on every PowerLibs component card: Preview, Settings, Instructions and YAML.

Overview

Every PowerLibs component card uses the same tabs, shown in this order:

  1. Preview - Live component preview
  2. Settings - Customization options (shown when the component has a settings editor)
  3. Instructions - Implementation guidance (only on components that have instructions)
  4. How to build - A step-by-step guide that rebuilds the component control by control (only on components that ship one; today that is the Accordion)
  5. YAML - Generated Power Apps code (always shown)

Card Header

The header above the tabs holds the name, the badges and three buttons:

  • Badges - NEW marks components added in the last 30 days. While you are signed out or on a free account, you also see FREE on the free components, ULTRA on full apps and a small lock icon on the other paid components
  • Link button (chain icon) - Copies the address of the page with the component's id after a #, so the link opens the page at this card and marks it for a moment. Once you have changed a setting, the link also carries your settings, and whoever opens it sees the note "Showing a shared configuration" with a Reset link. A configuration that is too large for a link shows an error message instead. On a phone the button only appears once a setting was changed
  • Theme toggle (sun and moon) - Switches the preview and the generated YAML between light and dark
  • Copy YAML - Copies the code from any tab (see the YAML Tab below)

Your changed settings are saved in your browser, per component. When you come back, the card shows "Restored your unsaved changes" with a Reset link that returns to the defaults.

Preview Tab

The Preview tab shows you how your component will look with your current settings.

Features:

  • Live Updates - Changes in Settings are reflected instantly
  • Interactive Elements - Test buttons, dropdowns, and other interactive features
  • Theme Support - The sun/moon button in the card header switches the preview and the generated YAML between light and dark. It does not change the website theme
Tip:

The preview is a browser rendering that follows your global Font setting. Always check the pasted result in Power Apps Studio.

Settings Tab

The Settings tab is where you customize your component to match your needs. A small live preview stays above the settings while you edit.

Common Settings:

  • Text Content - Labels, titles, descriptions
  • List Items - Tabs, menu entries and buttons you can add, remove and rename
  • Options - Features you can switch on or off, and variants you can pick from
  • Colors - Colour fields on the components whose editor has them; all other components follow your global Brand Color

Who can edit settings:

  • Accounts with a paid plan other than the old Components subscription - Can change every setting
  • Every other account - Sees the real editor, locked, with an Unlock button; a click anywhere on it opens the same prompt. Accounts on the Components subscription also see the note "Settings customization requires Ultra." See pricing for what each plan includes
Note:

A Reset to Default button at the bottom of the Settings tab puts every setting back to its starting value.

YAML Tab

The YAML tab contains the generated Power Apps code ready for export.

Features:

  • Clean Code - Readable YAML, ready to paste
  • Copy YAML - The Copy YAML button in the card header copies the code from any tab; the YAML tab also has its own Copy button. On components that offer Modern controls, Copy YAML opens a Select Version dropdown with Modern Controls and Classic Controls. The YAML tab shows the Classic version until you pick Modern Controls in that menu
  • Server Generation - While the YAML tab is open, the code is regenerated on the server shortly after you change a setting. You need to be signed in to see it
  • Locks - When the code cannot be shown, the tab shows a lock with the reason and a button instead: "Sign in to view the YAML" for signed-out visitors, or a note that the component, the full app or the dark theme is not part of your plan. Copy YAML reacts the same way: it opens the sign-in window when you are signed out, and the plans window when you are signed in and your plan does not cover the component

Code Structure:

This is the start of the code the Primary Button generates with its default settings (Classic Controls). Every control starts with its name and a Control: line, and every formula value starts with =:

- btnPrimary:
    Control: Classic/Button@2.2.0
    Properties:
      BorderColor: =RGBA(0, 0, 0, 0)
      BorderStyle: =BorderStyle.None
      BorderThickness: =0
      Color: =RGBA(255, 255, 255, 1)
      DisabledBorderColor: =RGBA(0, 0, 0, 0)
      DisabledColor: =RGBA(255, 255, 255, 1)
      DisabledFill: =ColorFade(RGBA(59, 130, 246, 1), 40%)
      Fill: =RGBA(59, 130, 246, 1)
      FocusedBorderThickness: =0
      Font: =Font.'Open Sans'
      FontWeight: =FontWeight.Semibold
      Height: =40
Tip:

The YAML code is ready to paste directly into Power Apps Studio - no modifications needed!

Instructions Tab

The Instructions tab provides quick implementation guidance for components that need it.

What You'll Find:

  • Step-by-step setup - How to implement the component
  • Integration advice - How to connect with your app logic
  • Common use cases - Real-world implementation examples
Note:

Not every component has an Instructions tab - only components that require specific implementation guidance include instructions.

Keyboard Shortcuts:

  • Left/Right arrow, Home, End - Move between the tabs once the tab list has focus
  • Ctrl/Cmd + Shift + C - Copy the YAML of the card under your mouse pointer, or of the card that has focus

Mobile Experience:

  • Tabs are optimized for touch devices
  • Settings panels are scrollable on smaller screens

What's Next?

Now that you understand the component interface, learn how to master the Settings & Customization panel to create components that perfectly match your brand and requirements.

Component Interface | PowerLibs