Customization
Match the Triagly experience to your brand with theming, CSS variables, and custom triggers.
Widget Theming
const triagly = new Triagly({
apiKey: 'pub_live_abc123',
// Appearance
theme: 'dark',
position: 'bottom-left', // or 'edge-left' for sidebar placement
buttonShape: 'pill', // 'rounded' | 'circular' | 'square' | 'pill' | 'expandable'
buttonText: 'Share feedback',
orientation: 'horizontal', // 'horizontal' | 'vertical'
offsetX: '20px', // Custom horizontal offset
offsetY: '20px', // Custom vertical offset
// Localized copy
placeholderText: 'Tell us what you think...',
successMessage: 'Thanks! Our team will take a look shortly.',
});Appearance Options
- theme — Force light or dark mode
- position — Any corner or edge placement
- buttonShape — rounded, pill, circular, square, expandable
- offsetX/offsetY — Fine-tune positioning
CSS Variables
Override CSS variables for pixel-perfect customization:
:root {
/* Floating button */
--triagly-button-bg: linear-gradient(135deg, #6366f1, #a855f7);
--triagly-button-bg-hover: linear-gradient(135deg, #4f46e5, #9333ea);
--triagly-button-text: #ffffff;
--triagly-button-radius: 999px;
/* Modal */
--triagly-modal-bg: #0f172a;
--triagly-modal-radius: 20px;
--triagly-modal-shadow: 0 30px 60px -15px rgba(15, 23, 42, 0.45);
--triagly-modal-backdrop: rgba(15, 23, 42, 0.65);
/* Form controls */
--triagly-input-bg: rgba(15, 23, 42, 0.7);
--triagly-input-border: rgba(148, 163, 184, 0.4);
--triagly-input-focus: #a855f7;
/* Accent */
--triagly-primary: #a855f7;
--triagly-success: #34d399;
--triagly-danger: #f87171;
}Custom Triggers
Hide the default button and trigger the widget from anywhere:
const triagly = new Triagly({
apiKey: 'pub_live_abc123',
buttonText: '', // Empty to hide default button
});
// Custom button trigger
const trigger = document.getElementById('feedback-btn');
trigger?.addEventListener('click', () => triagly.open());
// Keyboard shortcut (Cmd+K or Ctrl+K)
document.addEventListener('keydown', (event) => {
if (event.key === 'k' && (event.metaKey || event.ctrlKey)) {
event.preventDefault();
triagly.open();
}
});Ideas for Custom Entry Points
- Add a “Give Feedback” item to your user menu
- Connect to contextual help icons near complex features
- Provide a command-palette shortcut for power users
Pre-built Themes
Include a pre-built theme CSS file:
<!-- Dark theme -->
<link rel="stylesheet" href="https://unpkg.com/@triagly/sdk/themes/dark.css">
<!-- Minimal theme -->
<link rel="stylesheet" href="https://unpkg.com/@triagly/sdk/themes/minimal.css">
<!-- Gradient theme -->
<link rel="stylesheet" href="https://unpkg.com/@triagly/sdk/themes/gradient.css">