diff --git a/README.md b/README.md
index f8e272c..01cd240 100644
--- a/README.md
+++ b/README.md
@@ -1,41 +1,90 @@
-# Project Title
-Simple overview of use/purpose.
-## Description
-An in-depth paragraph about your project and overview of use.
-## Getting Started
-### Dependencies
-* Describe any prerequisites, libraries, OS version, etc., needed before installing program.
-* ex. Windows 10
-### Installing
-* How/where to download your program
-* Any modifications needed to be made to files/folders
-### Executing program
-* How to run the program
-* Step-by-step bullets
-```
-code blocks for commands
-```
-## Help
-Any advise for common problems or issues.
-```
-command to run if program contains helper info
-```
-## Authors
-Contributors names and contact info
-ex. Dominique Pizzie  
-ex. [@DomPizzie](https://twitter.com/dompizzie)
-## Version History
-* 0.2
-* Various bug fixes and optimizations
-* See [commit change]() or See [release history]()
-* 0.1
-* Initial Release
-## License
-This project is licensed under the [NAME HERE] License - see the LICENSE.md file for details
-## Acknowledgments
-Inspiration, code snippets, etc.
-* [awesome-readme](https://github.com/matiassingers/awesome-readme)
-* [PurpleBooth](https://gist.github.com/PurpleBooth/109311bb0361f32d87a2)
-* [dbader](https://github.com/dbader/readme-template)
-* [zenorocha](https://gist.github.com/zenorocha/4526327)
-* [fvcproductions](https://gist.github.com/fvcproductions/1bfc2d4aecb01a834b46)
\ No newline at end of file
+# wri-design-systems
+WRI UI Library
+
+## Requirements
+Node: `20.16.0`
+
+React: `18.3.1`
+
+## Installation
+```
+yarn add wri-design-systems
+```
+or
+```
+npm i wri-design-systems
+```
+
+## Other dependecies
+```
+yarn add @chakra-ui/react @emotion/react @emotion/styled framer-motion
+```
+or
+```
+npm i @chakra-ui/react @emotion/react @emotion/styled framer-motion
+```
+
+
+## Usage
+### Create the Project Theme
+With this custom theme you can change the color scheme according to your Project Theme
+
+```
+import { extendTheme } from '@chakra-ui/react'
+
+export const projectTheme = extendTheme({
+  colors: {
+    wri: {
+      neutral: {
+        300: '#ff5252',
+        500: '#ff0000',
+      },
+      primary: {
+        200: '#93ff93',
+        500: '#d80a5d',
+        600: '#16b816',
+        700: '#006100',
+      },
+      secondary: {
+        ...
+      },
+      success: {
+        ...
+      },
+    },
+  },
+})
+```
+
+### Wrap ChakraProvider at the root of your app
+```
+import * as React from 'react'
+import { projectTheme } from './lib/theme'
+
+// 1. import `ChakraProvider` component
+import { ChakraProvider } from '@chakra-ui/react'
+
+function App() {
+  // 2. Wrap ChakraProvider at the root of your app
+  return (
+    <ChakraProvider theme={projectTheme}>
+      <TheRestOfYourApplication />
+    </ChakraProvider>
+  )
+}
+```
+
+## Components
+### General
+* [Button](https://github.com/wri/wri-design-systems/tree/main/src/components/Button)
+* [NavigationRail](https://github.com/wri/wri-design-systems/tree/main/src/components/NavigationRail)
+* [TabBar](https://github.com/wri/wri-design-systems/tree/main/src/components/TabBar)
+
+### Controls
+* [Checkbox](https://github.com/wri/wri-design-systems/tree/main/src/components/Checkbox)
+* [Radio](https://github.com/wri/wri-design-systems/tree/main/src/components/Radio)
+* [Switch](https://github.com/wri/wri-design-systems/tree/main/src/components/Switch)
+
+### Layers
+* [LayerItem](https://github.com/wri/wri-design-systems/tree/main/src/components/LayerGroup)
+* [LayerItem](https://github.com/wri/wri-design-systems/tree/main/src/components/LayerItem)
diff --git a/src/components/Button/index.tsx b/src/components/Button/index.tsx
index e4a10e3..4c6cd0a 100644
--- a/src/components/Button/index.tsx
+++ b/src/components/Button/index.tsx
@@ -1,3 +1,4 @@
+import { Spinner } from '@chakra-ui/react'
 import { ButtonProps } from './types'
 import {
   BorderlessButton,
@@ -12,6 +13,8 @@ const Button = ({
   variant = 'primary',
   size = 'default',
   isDisabled,
+  leftIcon,
+  rightIcon,
   ...rest
 }: ButtonProps) => {
   let StyledButton = PrimaryButton
@@ -23,15 +26,32 @@ const Button = ({
     StyledButton = OutlineButton
   }
 
+  const getAriaLabel = () => {
+    let newLabel = rest['aria-label']
+    if (label) {
+      newLabel = label
+    }
+
+    if (isLoading) {
+      newLabel = 'Loading'
+    }
+
+    return newLabel
+  }
+
   return (
     <StyledButton
-      aria-label={label || rest['aria-label']}
-      isLoading={isLoading}
+      aria-label={getAriaLabel()}
       size={size}
-      isDisabled={isDisabled}
+      isDisabled={isDisabled || isLoading}
+      aria-disabled={isDisabled || isLoading}
+      leftIcon={!isLoading ? leftIcon : undefined}
+      rightIcon={!isLoading ? rightIcon : undefined}
       {...rest}
     >
+      {!rightIcon && isLoading ? <Spinner size='sm' marginRight='2' /> : null}
       {label}
+      {!!rightIcon && isLoading ? <Spinner size='sm' marginLeft='2' /> : null}
     </StyledButton>
   )
 }
diff --git a/src/components/Button/styled.ts b/src/components/Button/styled.ts
index ab81ceb..f0251f2 100644
--- a/src/components/Button/styled.ts
+++ b/src/components/Button/styled.ts
@@ -4,17 +4,22 @@ import { getThemedColor, ThemeProps } from '../../lib/theme'
 
 export const BaseButton = styled(Button)`
   width: ${({ size }) => (size === 'small' ? '120px' : '227px')};
-  height: ${({ size }) => (size === 'small' ? '24px' : '40px')};
+  height: ${({ size }) => (size === 'small' ? '28px' : '40px')};
   font-size: ${({ size }) => (size === 'small' ? '12px' : '16px')};
   line-height: ${({ size }) => (size === 'small' ? '16px' : '24px')};
   font-weight: 700;
-  padding: ${({ size }) => (size === 'small' ? '4px 12px' : '6px 12px')};
+  padding: ${({ size }) => (size === 'small' ? '4px 8px' : '6px 16px')};
   border-radius: 4px;
   box-shadow: 0px 1px 2px 0px #0000000d;
 
   &:focus-visible {
     box-shadow: none;
   }
+
+  svg {
+    width: ${({ size }) => (size === 'small' ? '10px' : '16px')};
+    height: ${({ size }) => (size === 'small' ? '10px' : '16px')};
+  }
 `
 
 export const PrimaryButton = styled(BaseButton)`
diff --git a/src/lib/theme.ts b/src/lib/theme.ts
index 93095f0..29ea289 100644
--- a/src/lib/theme.ts
+++ b/src/lib/theme.ts
@@ -60,11 +60,9 @@ export type ThemeProps = Theme & {
       secondary: {
         500: string
       },
-      controls: {
-        success: {
-          100: string
-          500: string
-        },
+      success: {
+        100: string
+        500: string
       },
     }
   }