Made for Magnetis' designers, developers, product managers, data analysts, data scientists, stakeholders and enthusiasts, Astro helps us protect the brand concepts, elevate consistency of user experience and increase the speed and efficiency of how we design and build products for our customers.
We believe that a good user experience is built with consistent design, well defined visual and interaction patterns, carefully built emotions and made for all. Therefore, Astro is essentially:
Astro is built based on Atomic Design, so our designers and developers can use its style set and components to enhance our product interface, as a modular system that can be easily managed and updated.
Magnetis believes that good design and experiences can impact the product market and society itself. Our design and code assets are open so we can contribute to the community and help new product teams.
Design is meant to be for all. Astro style and components follow basic recommendations from the WCAG guidelines for accessibility, with tested contrast ratios and good practices in legibility and screen reading solutions. See WCAG >>
For now, Astro only supports React as its official library.
Install Astro via terminal:
Run yarn add @magnetis/astro or npm install @magnetis/astro.
After you've imported Astro, you still need to add our fonts to your project manually.
You can get the updated font links either in the Typography page at astro.magnetis.com.br or inside the project folder in public/docz.html.
Ready to start coding with Astro? Follow the instructions in the docs (astro.magnetis.com.br) to learn how to use our components. You'll also see how to apply attribute modifiers (such as classes) to your HTML elements and React components.
Here's a quick example. If you'd like to create a Display text styled in Astro typography:
-
Complete all install steps listed above;
-
Import Astro in your file through one of the following methods:
-
Inside the
<head>tag:<head> <link href="/node_modules/@magnetis/astro/dist/astro.css" rel="stylesheet" type="text/css" /> </head>
-
With ES6 modules:
import "@magnetis/astro"; -
With commonjs:
require("@magnetis/astro");
-
-
Go to Astro's Typography page;
-
See that the "Display" section guides you to create a
<p>element with a specific text display class; -
Replicate the instructions in your page file and make sure the correct styles have been applied;
-
If your styles aren't rendered correctly, make sure Astro has been successfully installed into your project tree and
astro.cssis correctly imported.
When building layout structures, don't forget to use Flexbox Grid, which is already built in your project as an Astro dependency.
It's awesome that you want to contribute to Astro! Please see CONTRIBUTING.md to learn how it works.
Found a bug? Please see if it was already reported on our issues page. If you can't find a matching report, you can open a new issue including as much information as you can gather. We appreciate it!
Any lingering questions? You can contact us at dev@magnetis.com.br.
Thank you for using Astro! 🎉