Aksara UI 1.0

Description

Aksara is Kata.ai's design system. It contains foundations, voice and tone guidelines, component standards, and other guidelines that systematically improve quality, timeliness, and consistency to our product.

Aksara UI is an implementation of Aksara using the React framework. It is the true implementation of Aksara in raw code form, designed to communicate with users and bring delightful experiences. Aksara UI is the designation for Aksara React components.

Migrating

Aksara UI introduced a lot of changes compared to the previous version from the previous releases (0.x). Please read the migration guidelines for a smooth transition process.

Wicara 0.8 - "Chell"

Welcome to Wicara 0.8! This new release sees various major changes as a foundation to help shape the future of Wicara past this minor release.

Installation

Wicara 0.8 requires styled-components v4+. First, install the next version of the core Wicara package and styled-components.

# yarn
$ yarn add styled-components @wicara/core@next

# npm
$ npm install --save styled-components @wicara/core@next

Then, you will need to apply the style resets + theme provider. Wrap your app inside the WicaraProvider to use the resets and ThemeProvider component provided by Wicara.

import { WicaraProvider } from '@wicara/core';

export default function MyApp({ children }) {
  return <WicaraProvider>{children}</WicaraProvider>;
}

New features

Rewritten from the ground up

Wicara now uses styled-components, with styled-system as a method to build composable components using primitive props. Check them out!

New foundational components

Added several foundational components for improved flexibility and composability. See this storybook page for guides.

Simplified npm package structure

The architecture of Wicara 0.7 is based off of single npm packages per component. We quickly realised that this was a bad idea. So, we decided to merge them all into a single package, @wicara/core. Code-splitting is still available since we still publish an ES Module version of the package.

We've also provided the font stack we use on a separate package, @wicara/fonts.

New documentation URL

The documentation for Wicara has been migrated from Netlify to ZEIT Now. The new documentation URL can be found at wicara.now.sh. You can now open the "Notes" tab on each component story for guides on the corresponding component.

You can also read the README for detailed installation + usage guides.

Migration guide

To provide a smooth transition from Wicara 0.7, we provided the following migration guidelines. Please read if carefully when migrating your projects to Wicara 0.8.

We'd love your help!

Wicara is open source, which means it's also developed by the help of developers like you! Read our Contributing Guidelines to get started.

Wicara 0.8.0 - Alpha 1

Introducing a new alpha release of Wicara! This new release sees various major changes as a foundation to help shape the future of Wicara past this minor release.

Installation

Wicara 0.8 requires styled-components v4+. First, install the next version of the core Wicara package and styled-components.

# yarn
$ yarn add styled-components @wicara/core@next

# npm
$ npm install --save styled-components @wicara/core@next

Then, you will need to apply the style resets + theme provider. Wrap your app inside the WicaraReset to use the resets and ThemeProvider component provided by Wicara.

import { WicaraReset } from '@wicara/core';

export default function MyApp({ children }) {
  return <WicaraReset>{children}</WicaraReset>;
}

New features

• Rewritten from the ground up using styled-components and styled-system.
• New foundational components for improved flexibility and composability.
• Simplified to just 2 components: @wicara/core for all core components and @wicara/fonts for additional fonts.
  • Code-splitting is still available since we still publish an ES Module version of the package.
• Revamped many of the components inside.

Docs

Read the README on the next branch for detailed installation + usage guides. We also provide a completely-updated documentation on Storybook here. Open the "Notes" tab for guide on the corresponding component.

Migration guide

We're planning to write a detailed migration guide as we continue work on the alpha of Wicara 0.8. Stay tuned!

Wicara 0.7.0 - "Madeline"

Wicara 0.7, codenamed "Madeline", is the new beta release for Wicara. In this release, we're focusing on including some new components, bug fixes, as well as many architectural improvements.

• Upgraded to styled-components v4.0. Styled-components v4.0 introduced a lot of changes and new features. We will upgrade Wicara to this version to make use of these new features, as well as to prepare for further architectural improvements.
• Refactored theme variables. Rewrote theme + resets due to the changes in typings for styled-components v4. Implemented createGlobalStyle as global resets. Renamed variables to be more structured.
• Cleaned up Layout styles. This cleans up the layout styles further and brings the styles from our main platform to here. Also added an <AppRoot /> component, which aliases the new <Wrapper /> component for backwards compatibility.
• Added Skeleton component. This displays a placeholder elements for stuff still loading. Currently only supports loading texts, but in future release we'll add support for images.
• New starter kit! Clone the starter kit here for a quickstart on building apps with Wicara.

Read our documentation to get started on Wicara 0.7. Also, don't forget to star and fork us on GitHub. Your contributions help make Wicara better!