Release History
Learn about our latest updates, our release history, new guidelines, components, and tools.
The Indigo Design System has reached a significant milestone with the release of Version 3.0.0, which includes the following updates:
Code Base Update
- The entire Indigo Design System has been updated to Vue.js 3.0, enhancing performance, compatibility, and maintainability.
Style Update
- Introduced new, approved accent color for Indigo Design System.
- Source Sans 3 is now the default font for Indigo Design System.
Component Updates
- All components have been updated, with:
- High-quality, production-ready code.
- Updated documentation and examples for both Vue and HTML/CSS implementations.
- Responsiveness improvements for modern devices.
This release includes breaking changes.
New Features
For Developers
- Vue 3 Migration.
- Major refactor of the component library from Vue 2 to Vue 3 (including updates to project structure, build process with Vite, and dependency changes).
- Components now use Vue 3’s setup, syntax and v-model updates where applicable (e.g., Checkbox.vue, Select.vue, DatePicker.vue).
- Horizontal and Side Navigation Components
- Introduced new Horizontal Navigation and Side Navigation components for streamlined site navigation. Includes responsive fixes, hover states, and alignment improvements. Includes responsive fixes, hover states, and alignment improvements.
- Select Component
- Switched from VSelect to VAutocomplete for better filtering and consistent UI.
- Improved model-value handling for vee-validate.
- New Multi-Select & Filter Components
- The Multi-Select component from Indigo 2.0 has been renamed “Filter.” We have updated the styling of the Filter component to match global updates.
- We created a new Multi-Select that is better-suited for forms and filters that require a large number of selections. The new component features select-all capability, truncated labels for large selections, and improved search text color.
- Loader & Progress Bar Components
- Added new loader variations.
- Revised progress bar with updated icons and states.
- New Sticky Anchor Links Component
- Added a new Sticky Anchor Links component to help users track their position and navigate in longer documentation.
- Introduced scroll-based “sticky anchor” functionality using ScrollMonitor.
For Designers
- UI Updates
- Comprehensive rework of UI components to align with new Indigo 3.0 design patterns.
- Refined UI Components with updated spacing, hover states, vertical alignment, and icon usage.
- Updated component documentation pages with refined examples and usage tips.
- New sections for design and layout, covering component anatomy and style variations.
- Updated Dos and Don’ts section with new rules and standards for the Indigo Design System.
- Downloadable design assets for Figma.
- Redesigned icons in SVG and PNG formats.
- Access to Indigo’s Figma Icon Plugin.
- Pre-designed layouts and templates to accelerate mockup creation.
Updates
- Performance & Responsive Layout: Numerous small fixes for mobile/tablet breakpoints
- Added mobile/tablet variants for key interactive components: Breadcrumbs, Pagination, Dropdown Menu, Button, Input Group, Date Picker, Input, Multi-Select, Select, Text Area, Radio Button Group, Radio Button, Checkbox Group, and Checkbox
- Adjusted default container widths (1480px) and grid margins for larger screens
- Accessibility & Event Handling
- Fixed tooltip behavior, date picker colors, and “click” events for certain components without a callback handler.
- Updated Accordion.vue click logic so it doesn’t capture all native clicks.
- Data Table Improvements: Sorting icons added, revised tooltip alignment, and smaller bug fixes around styling and placeholders.
- Documentation & Infrastructure
- Improved README instructions (e.g., how to run Vue 3 locally).
- Merged multiple pull requests consolidating bug fixes and finalizing version merges.
Breaking Changes
- Radio Buttons & Groups: Groups wrapped in
indi-form_radio-button-group--container
, with error and focus states.
- To use the Multi-Select component, please import indigoVuetify:
import { indigoVuetify } from "indigo-component-library/src/common/vuetify"; let app = createApp(App); app.use(indigoVuetify);
- Migration to Vue 3
- Many components changed their props, events, and/or v-model behavior to align with Vue 3 best practices.
- If your project is still on Vue 2, you will need to upgrade before consuming this version.
- Select Component Swap
- VSelect replaced by VAutocomplete: usage, slots, and styling might differ from older versions. Existing consumers may need to update references and styling overrides.
- Some internal classes and SCSS structures (e.g., for MultiSelect, Notification, DataTable) were refactored for consistency. Custom overrides may break if targeting removed classes.
- Typography & Layout Adjustments: Header classes (indi-heading-level-*), paragraph utility classes, and grid breakpoints changed. If you were relying on the old naming or sizes, you’ll need to update.
Tokens
- New Typography Tokens
indi-heading-level-1-display
indi-heading-level-1-default
with updated body-level fonts and line-heights.
- Adjusted grid spacing for extra-large screens (1608px+).
- Introduced small spacing tokens for inputs, tooltips, and other UI elements.
New Features
- Added new map icons.
- Added "Revert" icon to Icon Library.
- Data Tables update: Keep selected rows after page switch (optional feature to maintain checkbox selection across pages).
- Added text in DataTable tooltip. This makes Tooltip available for a text table cell.
Bug Fixes
- Fixed missing row number and cell number in Data Table row and cell IDs; added IDs to some components in Data Table component.
- Added new map icons.
New Features
- Vue-the-mask added to Indigo library and Data Tables.
- Checkbox support added to Data Tables and removed header slot left margin to allow header checkbox to align with body.
- Added Progress Bars variation to prevent clicking on non-complete step.
- Created Ellipsis component for use inside a Data Tables cell that aligns with the parent div.
- Filter variation added.
Bug Fixes
- Filter Select All function bug fixed.
- Period removed from end of "Displaying…" Pagination component .
- "-fixed" added to Fixed Header row ID to remove duplicate ID for 508 compliance.
- Black button border removed from Accordions.
Accessibility Improvements
- Breadcrumbs and Dropdown Menus 508 compliance improved.
- Aria-label added to Checkbox.vue, checkbox cell in DataTable.vue, and DataTableHead.vue for 508 compliance.
- Data Tables role changed from table to presentation and header ID property added for 508 compliance.
- Tabindex added in App Footer, Data Tables, and Data Table Header for 508 compliance.
- Reassigned icon in Success Message to decorative element for 508 compliance.
Enhancements
- Optional target parameter for hyperlink added to App Footer.
- Vue-the-mask added to Indigo library and Data Tables.
New Features
- Added four new Icons: bell, move-expand-vertical, move-shrink-vertical, sort
Bug Fixes
- Fixed a styling bug in Accordions.
- Added four new Icons: bell, move-expand-vertical, move-shrink-vertical, sort
New Features
- Additional pagination slot added to accommodate filters.
- Map Overlay, Map Drawer and Map Legend documentation Added
Bug Fixes
- Data Table internal data model bugfix.
- Additional pagination slot added to accommodate filters.
New Features
- Accordions created and documented.
- Dropdown Menu created and documented.
- Filter Row created and documented.
- Filter created and documented.
- Overlay Panel created and documented.
- New map components: Map Drawer, Map Legend, and Map Overlay created and documented (future documentation release planned).
Updates
- App Footers and App Headers additional variations documented.
- Data Tables documentation for advanced features: batch actions, responsiveness, cell highlighting, and inline data entry.
- Restored static CSS asset build: Indi.css and Sprite now available in release ZIP file.
Accessibility Improvements
- Icons improved a11y structure.
- Fieldset & Legend improved a11y structure.
- Accordions created and documented.
New Features
- Forms extended with compact versions for: Checkboxes,
Date Pickers, Inputs,
Radio Buttons, Selects,
and Textareas
- Forms extended with smart defaults for autocapitalize, autocorrect, and autocomplete:
- Page Shell extended with a full-bleed behavior.
- Added new Icons: checkmark, file-zip, map-globe, map-zoom-to-area.
- Added the Content Guide.
Updates
- Forms: Deprecated
groupLabel
prop. Renamed tolabel
for consistency.- Affects Input Groups, Checkbox Groups, and Radio Button Groups.
- App Footers and App Headers extended with additional variations.
- Data Tables introduced undocumented features: batch actions, responsiveness, cell highlighting, and inline data entry. Documentation coming in a future release.
- Long Form Text updated link styling.
- Progress Bars darkened text color to improve accessibility and changed hover colors to improve usability.
- Selects: Altered
options
prop syntax to simplify array format. Old format is deprecated.
Accessibility Improvements
- Date Pickers changed icon color.
- Fieldsets & Legends improved accessibility.
- Help Text darkened text color to improve accessibility.
- Forms extended with compact versions for: Checkboxes,
Date Pickers, Inputs,
Radio Buttons, Selects,
and Textareas
v2.0.0
December 20, 2019This release converts all existing Indigo components and doc pages to the Vue.js framework.
Backwards compatibility & breaking changes
- This release includes breaking changes.
- Product teams upgrading their Indigo dependency from v1.2.0 to v2.0.0 should be aware of and test for the breaking changes detailed in the release notes below.
- Indigo markup is documented for both Vue and HTML to
maintain backwards compatibility. The
indi-
namespace has not changed.
Designers
- Indigo Figma library accompanies v2.0.0 and matches its scope.
- Components in Figma now use tokens for aspects of visual style, such as color and typography.
- The library also includes upcoming components that haven't been built yet. These are clearly marked on the sticker sheets to avoid confusion.
This release includes breaking changes.
New Features
- Created Layouts & Sample Pages demonstrating realistic compositions of all components. A code view for each page gives developers a model.
- Page Shell, App Footer, and App Header: Adds new component, sink page, and documentation page.
- Tooltips: Icons now imported as Vue components with added annotation slots.
- Homepage: Revised homepage design and content.
Updates
- Color Palette: Added
$text-color-primary-on-dark
token; updated blue-related tokens.
- Forms: Divided into individual component pages; added to
i-form
to code examples; deprecatedindi_input_row
for Indigo Grid instead.
- Notifications: Updated icon rendering to Vue components with
color
instead offill
.
- Long Form Text: Adjusted spacing for headings and lists.
- Modal: Updated guidance and code documentation.
- Pagination: Bug fix, added prop for current page, improved documentation.
Breaking Changes
- Checkboxes & Groups wrapped in
indi-form__checkbox-group--container
, with error and focus state.
- Date Pickers: Now uses V-Calendar Vue plug-in.
- File Inputs: Promoted to full component from input modifier.
- Radio Buttons & Groups wrapped in
indi-form__radio-button-group--container
, with error and focus states.
- Selects: Updated error styles and normalized with other inputs.
Tokens
- Added
$border-radius-s
.
Pre-release v2.0.0-beta
November 15, 2019This Beta preview release includes all existing components and doc pages converted to the Vue Javascript framework. Indigo markup is documented for both Vue and HTML.
- A new version of the Indigo Figma library accompanies this release and matches its scope.
- Expect a General Availability release that will replace the current v1.2.0 in December 2019. This release will include additional Vue documentation and tools for creating Vue applications.
- This release has no breaking changes to HTML markup. However, the Vue framework option implies a breaking change to all future implementations, so the system version is incrementing to 2.0.0.
This release includes breaking token changes to the color palette, detailed in the notes below.
New Features
- Tags: Added component and sink pages.
- Page Shell Components: Alpha version includes AppHeader, AppFooter, HorizontalNav, updates to SideNav, and PageShell. Full layouts and applications coming in future releases.
Updates
- Color Palette:
Adjusted interactive blues for accessibility. Deprecated
$indi-color-blue-42
(replaced by$indi-color-blue-38
) and accent colors$indi-color-accent-32
and$indi-color-accent-50
. Added map-specific palette for points, fills, and ramps.
- Breadcrumbs: Improved link color for accessible contrast.
- Long Form Text: Updated H2 color from
$indi-text-color-secondary-default
to$indi-text-color-primary-default
.
Component Conversions to Vue
- Following pages have been converted from markup and doc page to Vue:
File Objects,
Loaders, Notifications,
Modals, Data Tables,
Pagination, Progress Bar,
Side Nav,
Tooltips, Tabs
Pre-release v2.0.0-alpha
October 4, 2019This Alpha preview release features a subset of components and doc pages converted to the Vue Javascript framework. Indigo markup will now be documented for both Vue and HTML.
Expect a Beta preview release with additional components in about two sprints, followed by a fully converted General Availability release that will replace the current v1.2.0.
This release has no breaking changes to HTML markup. However, the Vue framework option implies a breaking change to all future implementations, so the system version is incrementing to 2.0.0.
Updates
- About Pages: Pages: Converted to Vue, including Getting Started, Accessibility Standards, Feedback and Requests, and Release History.
- Visual Style Pages: Converted to Vue, including Color, Logo, Space, and Typography.
Component Conversions to Vue
- Breadcrumbs, Buttons,
Forms, File Object (with demo in File Upload),
Grids, Icons,
Loaders, Notifications:
Component markup and documentation pages converted to Vue.
- Page Example: Form (Centered) converted to Vue.
- Homepage converted to Vue.
New Features
- Form Validations: Added prototype page for forms.
- File Upload Guidelines: Publishes guidelines for file uploads.
- Progress Bar: Published component page.
- File Object: Published component page.
- Accessibility: Published documentation page.
Updates
- Typography: Changed H5 to semibold and responsive type sizes to mixins.
- Long Form Text:
- Added responsive type sizes and bottom margins.
- Removed top margin on header elements when first child.
- Added an implementation example with other components.
- Forms:
- Updated Legend to match H3. Changes Labels to match H5.
- Adjusted Radio Button and Checkbox dimensions to 24px X 24px.
- Updated Radio and Checkbox label font size to match body text and to accomodate long text with left indent.
- Changed disabled form element colors to increase contrast.
Improvements
- Side Nav: Added JS to scroll active link into view.
- Form Validations: Added prototype page for forms.
v1.1.0
August 18, 2017New Features
- File Object: Adds sink page and starts component page.
- Forms: Adds Date Picker Input, File Input and File Upload.
- Page Examples: Adds Form (File Upload) prototype page.
Updates
- Icons
- Adds vertically align modifier class.
- Moves external link icon after text in links.
- Adds IE SVG sprite support section to docs.
- File Object: Adds sink page and starts component page.
v1.0.1
July 26, 2017New Features
- Icons: Adds CSV file icon.
Updates
- Feedback and Requests: Updates Indigo Project Backlog link. Changes “usac.org” to “universalservice.org” in the footer.
- Forms: Removes File input example pending further development.
- Icons: Adds CSV file icon.
v1.0.0
June 15, 2017New Features
- Loader: Published component page.
- Long Form Text: Published component page.
- Modal: Published component page.
- Grids: Published component page.
- Home: Published home page.
- Getting Started: Published documentation page.
- Feedback and Requests: Added documentation page.
Updates
- Doc Site: Adds footer.
- Forms: Added File input style and example, changes font size on inputs
and select menu, and adds example of inputs next to button.
Improvements
- Long Form Text: Added top margins to elements, removes
bottom margins, and renames paragraph modifier class selectors.
- Loader: Published component page.
v0.6.0
June 2, 2017New Features
- Progress Bar: Added component and sink page.
- Pagination: Published component page.
- Data Tables: Published component page.
- Tabs: Published component page.
- Typography: Published documentation page.
- Page Examples: Added Article 1 and Article 2 prototype pages.
- Breadcrumbs: Added documentation page.
- Form Elements: Added documentation page.
Updates
- Base - Added basic
html, body { margin: 0; padding: 0;}
reset.
- Doc Site: Added sticky header and scrolling left navigation column.
Improvements
- Tabs: Refactored component to fix overflow issue.
- Form Elements: Added 100% width responsive behavior to Form specific grid
on mobile. Removed required
*
and adds(optional)
treatment for labels.
- Progress Bar: Added component and sink page.
v0.5.0
May 19, 2017New Features
- Loader: Added component and sink page.
- Tooltips: Published component page and removed javascript. Made tooltip right as default variation.
- Icons: Published Icons.
- Page Examples: Added Form (Left Nav) and Form (Centered) prototype pages.
- Side Nav: Added component and sink page.
Updates
- Forms: Added
textarea
,fieldset
,legend
and form specificinput-group
grid.
- Logo: Published Logo usage.
- Loader: Added component and sink page.
v0.4.0
May 9, 2017New Features
- Code Style Guide: Added browser standards.
- Breadcrumbs: Added component and sink page.
- Notifications: Published component page.
- Tabs: Added component and sink page.
Updates
- Color: Updated color tokens to use lightness value and publishes doc page.
- Space: Updated space tokens and publishes doc page.
- Typography: Changed font from
@import
to web font<link>
.
Improvements
- Long Form Text: Added
ul
andol
styles.
- Tooltips: Added show/hide toggle on click behavior.
- Modal: Added
indi-modal--is-open
modifier class.
- Code Style Guide: Added browser standards.
Pre-release v0.2.0
April 7, 2017New Features
- Doc Site: Started Template
- Code Style Guide: Added documentation page.
- Icons: Added placeholder icons.
- Long Form Text: Added component and documentation page.
- Notifications: Added component and sink page.
- Tooltips: Added component and sink page.
Updates
- Buttons: Published component page. Removes alternative Secondary Button variation.
- Doc Site: Started Template
Pre-release v0.1.0
March 24, 2017New Features
- Base Environment.
- Color Tokens: Added approved color variables.
- Buttons: Added component and sink page.
- Forms: Added component and sink page.
- Base Environment.