diff --git a/.storybook/main.js b/.storybook/main.js
index f8ddf4b5..d7bfc73e 100644
--- a/.storybook/main.js
+++ b/.storybook/main.js
@@ -5,6 +5,7 @@ module.exports = {
'../packages/comet-uswds/src/**/*.stories.@(tsx|mdx)',
'../packages/comet-data-viz/src/**/*.stories.@(tsx|mdx)',
'../packages/comet-extras/src/**/*.stories.@(tsx|mdx)',
+ '../packages/comet-uswds/src/**/*.mdx',
],
addons: [
getAbsolutePath('@storybook/addon-links'),
diff --git a/.storybook/preview.js b/.storybook/preview.js
index 3d64a91d..ec1725bc 100644
--- a/.storybook/preview.js
+++ b/.storybook/preview.js
@@ -8,4 +8,16 @@ export const parameters = {
date: /Date$/,
},
},
+ options: {
+ storySort: {
+ order: [
+ 'Welcome',
+ 'Style Guide',
+ ['Colors', 'Typography', 'Icons'],
+ 'USWDS',
+ 'Extras',
+ 'Data Viz',
+ ],
+ },
+ },
};
diff --git a/packages/comet-uswds/src/style-guide/Colors.mdx b/packages/comet-uswds/src/style-guide/Colors.mdx
new file mode 100644
index 00000000..c84bdd4c
--- /dev/null
+++ b/packages/comet-uswds/src/style-guide/Colors.mdx
@@ -0,0 +1,25 @@
+import { Meta, ColorPalette, ColorItem } from '@storybook/blocks';
+
+
+
+# Colors
+
+
+
+
+
+
diff --git a/packages/comet-uswds/src/style-guide/Icons.mdx b/packages/comet-uswds/src/style-guide/Icons.mdx
new file mode 100644
index 00000000..f285aeef
--- /dev/null
+++ b/packages/comet-uswds/src/style-guide/Icons.mdx
@@ -0,0 +1,7 @@
+import { Meta, Title } from '@storybook/blocks';
+
+
+
+# Icons
+
+Comet provides USWDS icons as a React component. Examples can be found here.
diff --git a/packages/comet-uswds/src/style-guide/Typography.mdx b/packages/comet-uswds/src/style-guide/Typography.mdx
new file mode 100644
index 00000000..711b23d6
--- /dev/null
+++ b/packages/comet-uswds/src/style-guide/Typography.mdx
@@ -0,0 +1,50 @@
+import { Meta, Typeset } from '@storybook/blocks';
+
+
+
+export const typography = {
+ type: {
+ primary: "'Source Sans Pro','Helvetica Neue', 'Helvetica', 'Roboto', 'Arial', sans-serif",
+ },
+ weight: {
+ light: '300',
+ normal: '400',
+ bold: '700',
+ },
+ size: {
+ '3xs': 12,
+ '2xs': 14,
+ xs: 16,
+ sm: 17,
+ md: 18,
+ lg: 24,
+ xl: 32,
+ '2xl': 40,
+ '3xl': 56,
+ },
+};
+
+export const SampleText = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.';
+
+# Typography
+
+**Font:** Source Sans Pro
+
+**Weights:** 300(light), 400(normal), 700(bold)
+
+
diff --git a/packages/comet-uswds/src/style-guide/Welcome.mdx b/packages/comet-uswds/src/style-guide/Welcome.mdx
new file mode 100644
index 00000000..1f86f30f
--- /dev/null
+++ b/packages/comet-uswds/src/style-guide/Welcome.mdx
@@ -0,0 +1,92 @@
+import { Meta } from '@storybook/blocks';
+
+
+
+
+
+ # Welcome to Comet!
+
+ Comet is a React with TypeScript Component Library based on USWDS.
+
+ Comet was built with a primary focus on USWDS, however it has become more of a framework for React Apps that require USWDS, as well as other functionality (charts, custom components, etc). In the end, we hope to provide a set of modular tools to accelerate developer productivity and simplify the use of Design Systems, particularly USWDS.
+
+
+
+
+
USWDS
+
The base USWDS component library is implemented in React with TypeScript.
+
+
+
Extras
+
A set of custom components, intended to fill in the gaps where USWDS does not provide an implementation.
+
+
+
+
Data Viz
+
A set of Victory Chart components is provided as a Comet wrapper.
+
+
+
+
+
+
Getting Started
+
+ Please review the following repo for details on getting started:
+ Comet Component Library
+
+
+
+
+
+