From 81d9034070ece9a3e29b9122ff52c49350454499 Mon Sep 17 00:00:00 2001 From: jezzahehn Date: Fri, 9 May 2025 01:36:08 -0400 Subject: [PATCH] docs: Adding atomic design directories and brief explainer files --- src/components/atoms/atoms.md | 9 +++++++++ src/components/molecules/molecules.md | 9 +++++++++ src/components/organisms/organisms.md | 11 +++++++++++ 3 files changed, 29 insertions(+) create mode 100644 src/components/atoms/atoms.md create mode 100644 src/components/molecules/molecules.md create mode 100644 src/components/organisms/organisms.md diff --git a/src/components/atoms/atoms.md b/src/components/atoms/atoms.md new file mode 100644 index 0000000..b009074 --- /dev/null +++ b/src/components/atoms/atoms.md @@ -0,0 +1,9 @@ +# What are atoms? + +https://bradfrost.com/blog/post/atomic-web-design/ + +Atoms are the basic building blocks of matter. Applied to web interfaces, atoms are our HTML tags, such as a form label, an input or a button. + +Atoms can also include more abstract elements like color palettes, fonts and even more invisible aspects of an interface like animations. + +Like atoms in nature they’re fairly abstract and often not terribly useful on their own. However, they’re good as a reference in the context of a pattern library as you can see all your global styles laid out at a glance. \ No newline at end of file diff --git a/src/components/molecules/molecules.md b/src/components/molecules/molecules.md new file mode 100644 index 0000000..a350588 --- /dev/null +++ b/src/components/molecules/molecules.md @@ -0,0 +1,9 @@ +# What are molecules? + +https://bradfrost.com/blog/post/atomic-web-design/ + +Things start getting more interesting and tangible when we start combining atoms together. Molecules are groups of atoms bonded together and are the smallest fundamental units of a compound. These molecules take on their own properties and serve as the backbone of our design systems. + +For example, a form label, input or button aren’t too useful by themselves, but combine them together as a form and now they can actually do something together. + +Building up to molecules from atoms encourages a “do one thing and do it well” mentality. While molecules can be complex, as a rule of thumb they are relatively simple combinations of atoms built for reuse. \ No newline at end of file diff --git a/src/components/organisms/organisms.md b/src/components/organisms/organisms.md new file mode 100644 index 0000000..7c62cbc --- /dev/null +++ b/src/components/organisms/organisms.md @@ -0,0 +1,11 @@ +# What are organisms? + +https://bradfrost.com/blog/post/atomic-web-design/ + +Molecules give us some building blocks to work with, and we can now combine them together to form organisms. Organisms are groups of molecules joined together to form a relatively complex, distinct section of an interface. + +We’re starting to get increasingly concrete. A client might not be terribly interested in the molecules of a design system, but with organisms we can see the final interface beginning to take shape. Dan Mall (who I’m working with on several projects) uses element collages, which articulate ideas for a few key organisms to facilitate client conversations and shape the visual direction (all without having to construct full comps). + +Organisms can consist of similar and/or different molecule types. For example, a masthead organism might consist of diverse components like a logo, primary navigation, search form, and list of social media channels. But a “product grid” organism might consist of the same molecule (possibly containing a product image, product title and price) repeated over and over again. + +Building up from molecules to organisms encourages creating standalone, portable, reusable components. \ No newline at end of file