diff --git a/packages/base-style/README.md b/packages/base-style/README.md
index b2e76fecbfb8..dd2737462843 100644
--- a/packages/base-style/README.md
+++ b/packages/base-style/README.md
@@ -1,11 +1,74 @@
 # `deriv-base-style`
+> Responsible for the basic style setup for all packages.
 
-> TODO: description
+Includes:
+* Animations
+* Devices - media query breakpoints
+* Mixins
+* Reset
+* Colors - all color variables
+* Fonts - font variables and setup
 
 ## Usage
 
-```
+```js
 const baseStyle = require('base-style');
+```
+
+### Examples
+
+#### Devices:
+```scss
+    .some-class {
+        @include respond(mobile) {
+            max-width: 500px;
+        }
 
-// TODO: DEMONSTRATE API
+        @include respond(laptop) {
+            max-width: 1200px;
+        }
+    }
 ```
+
+#### Fonts
+The `@typeface($var, $text-transform)` mixin can be used to style any text element. Simply pass in a typeface `$var` name to the mixin.
+The `$var` name is in the format `--$FONT_SIZE-$TEXT_ALIGN-$FONT_WEIGHT-$COLOR`.
+
+Refer to `fonts.scss` for a list of valid font-sizes, text-align, font-weights & colors.
+
+```scss
+// Define bold red title, align to the left
+h1 {
+    @include typeface(--title-left-bold-red);
+}
+```
+The optional second argumant in the `@typeface` mixin sets the `text-transform`.
+```scss
+// Define an uppercased paragraph with color orange and font-weight 300
+p {
+    @include typeface(--paragraph-center-light-orange, uppercase);
+}
+```
+
+To define new typefaces, add the name and value in the `$FONT_SIZES`, `$FONT_WEIGHTS` or `$COLORS` maps accordingly in `fonts.scss` file.
+
+#### Mixins
+```scss
+// mixins.scss
+@mixin link {
+    color: $COLOR_WHITE;
+
+    &:hover, &:active {
+        text-decoration: none;
+    }
+}
+// package
+.sidebar {
+    background: $COLOR_LIGHT_GRAY;
+
+    a {
+        @include link;
+        display: block;
+    }
+}
+```
\ No newline at end of file
diff --git a/packages/component/README.md b/packages/component/README.md
new file mode 100644
index 000000000000..c816a6be2df7
--- /dev/null
+++ b/packages/component/README.md
@@ -0,0 +1,15 @@
+# `component`
+> Reusable UI components for Deriv.
+
+## Usage
+```jsx
+import Button from 'deriv-ui/lib/Button';
+
+const SomeComponent = () => (
+    <Button is_disabled primary>
+      Hello World
+    </Button>
+  );
+```
+
+## Components