<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Alex on Medium]]></title>
        <description><![CDATA[Stories by Alex on Medium]]></description>
        <link>https://medium.com/@alex-quarkly?source=rss-5a286a497196------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*WUDmgROdpTED6dxP6bneBA.jpeg</url>
            <title>Stories by Alex on Medium</title>
            <link>https://medium.com/@alex-quarkly?source=rss-5a286a497196------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 13:03:09 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@alex-quarkly/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Creating an App with a Staff Base in React using Airtable and Quarkly]]></title>
            <link>https://medium.com/swlh/creating-an-app-with-a-staff-base-in-react-using-airtable-and-quarkly-12f51b7e4bc4?source=rss-5a286a497196------2</link>
            <guid isPermaLink="false">https://medium.com/p/12f51b7e4bc4</guid>
            <category><![CDATA[low-code]]></category>
            <category><![CDATA[airtable]]></category>
            <category><![CDATA[react]]></category>
            <category><![CDATA[development]]></category>
            <category><![CDATA[javascript]]></category>
            <dc:creator><![CDATA[Alex]]></dc:creator>
            <pubDate>Tue, 09 Mar 2021 10:11:34 GMT</pubDate>
            <atom:updated>2021-03-09T10:11:34.838Z</atom:updated>
            <content:encoded><![CDATA[<p>This post is the first in a series of tutorials where we will explain how to work with Quarkly. In this tutorial, we will create a simple web app to show a company’s employee profiles.</p><p>We will develop the front end with Quarkly and upload the data from the Airtable database. As a result, we will get a React app synchronized with the database.</p><h3>Introduction. Why Airtable?</h3><p>Airtable is a popular no-code tool for creating large databases. They look like tables but have much more powerful functionality. We chose Airtable for our tutorial because it’s easier to transfer data via API.</p><p>If you are new to Airtable, read the <a href="https://support.airtable.com/hc/en-us/sections/360009677453">official guide</a> on the company website before working with it.</p><p>For the front-end <a href="https://quarkly.io/">Quarkly</a> part we will use just two components:</p><ul><li><em>An employee card</em>. It will contain a photo, text, and two buttons: send email and call. The card will receive this data from the parent component — the wrapper.</li><li><em>Wrapper</em>. It will fetch data from Airtable, generate cards, and pass data to them.</li></ul><p>If you don’t have time to read the whole post, you can watch this video with subtitles and time codes:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FmbPukPi0RZA%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DmbPukPi0RZA&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FmbPukPi0RZA%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/51fb81251becba05d67ea1452b45fdac/href">https://medium.com/media/51fb81251becba05d67ea1452b45fdac/href</a></iframe><h3>Part 1. Develop front end on Quarkly</h3><h4>To create a card:</h4><ol><li>Create a new project on Quarkly. Let’s call it <em>Airtable Example</em>;</li><li>Go to the project;</li><li>Add a ready-made block with employee cards. To do this, click on the black “+” icon and select a block from the <em>Team </em>category;</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*C_LJ5o33Lm9DTIIUudX6gA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Tmmkrcy7SD-CBCTF05zAMQ.png" /></figure><p>4. Select the first card (<em>StackItem</em>) on the Layers panel and turn it into a component;</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/820/1*UcBdsVU41eXXE4ByMrEaOw.png" /></figure><p>To do that, click on the “3 dots” icon and select “Convert to Component”. Let’s call this component <em>EmployeeCard</em>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Guaefvuc89QwTUF1iSq2Yg.png" /></figure><p>5. Now you can easily edit the code of this React component, but let’s not do that right now. Let’s first create the wrapper component.</p><h4>To create a wrapper:</h4><ol><li>Prepare the wrapper for conversion into a component. To do this, first remove the other three cards (we don’t need them);</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*aVcnTBUPnRwHxW8uQKTA-A.png" /></figure><p>2. Now take <em>EmployeeCard</em> from <em>Stack</em>. Then convert the <em>Stack </em>into a component, just as we did before with <em>EmployeeCard</em>: the right panel, “3 dots” icon, and “Convert to Component”. Let’s call the component <em>EmployeeTable</em>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*eMdYmeH7rNs_6rIHhLEJJQ.png" /></figure><p>That’s all for now. The first stage is over. Let’s leave the components and create a database on Airtable.</p><h3>Part 2. Create a database on Airtable</h3><p>Go to <a href="https://airtable.com/">Airtable</a> and sign up/log in.</p><ol><li>Click on the “Add a base” button to create a new base. Select “Start with a template” from the drop-down menu;</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*j6i3HkJe_CdwptbL29n6XA.png" /></figure><p>2. Select “HR &amp; Recruiting” and the “Employee directory” template. Then click on the “Use template” button;</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IxB87EfLnF1g0h3IDmn5Sw.png" /></figure><p>3. Go to the created project;</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*J0Sm6yFOiNXVxcXuiGND9w.png" /></figure><p>We are not going to change anything at this stage: the base is fine as it is.</p><h3>Part 3. Get access to the API</h3><p>We first decided to use Airtable because of its user-friendly API. And it’s also important that Airtable allows taking data and sending it to our database for free.</p><ol><li>Go to the API project selection page: <a href="https://airtable.com/api">https://airtable.com/api</a></li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*38uJ1kQO9mPGlypzaQ6xRw.png" /></figure><p>2. Select our project <em>Employee directory</em>. In the documentation that will appear, go to “AUTHENTICATION”.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QUunWOm9NXkrKNYcvhjnJA.png" /></figure><p>3. Copy the following two lines below the “EXAMPLE USING BEARER TOKEN (RECOMMENDED)” heading:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c23d5cdc0bfce1536e2c97a8fc12f56f/href">https://medium.com/media/c23d5cdc0bfce1536e2c97a8fc12f56f/href</a></iframe><p>4. Now you need YOUR_API_KEY. It’s a unique access key generated for each account. You can find it in your settings.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/431/1*eGOYRpO7Faco8ZajEku2tg.png" /></figure><p>5. On the page that will appear, go to the API section and click on the “Generate API key” button;</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MA76Ityf-G-wZZTjkB9UoA.png" /></figure><p>6. Copy the key and save it next to the lines from step 3. You will need it later.</p><h3>Part 4. Integrate Airtable base into Quarkly</h3><p>In this stage, you will add code to the <em>EmployeeTable</em> component that will fetch data from the API.</p><ol><li>Go to the code editor. To do this, open the “Components” tab and click on the “&lt;&gt;” icon next to <em>EmployeeTable</em> (it will appear when mousing over the component);</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*H2mxV2oLSx7AVEZpKNKgkA.png" /></figure><p>2. Now the component code looks like this:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/895/1*beuqRbTbxWVRcGBTWMUOnQ.png" /></figure><p>3. Replace:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/12679a21c270441833527f5869804b8d/href">https://medium.com/media/12679a21c270441833527f5869804b8d/href</a></iframe><p>with</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/52da94f8ff8dd13f27009d239e23f3ea/href">https://medium.com/media/52da94f8ff8dd13f27009d239e23f3ea/href</a></iframe><p>This way, you import the <em>useEffect</em> and <em>useState </em>hooks that you will need later;</p><p>4. Add the following line below to import the <em>EmployeeCard </em>component:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/314cdb0450cc938a8e4357cb1c41817c/href">https://medium.com/media/314cdb0450cc938a8e4357cb1c41817c/href</a></iframe><p>5. Replace <em>children</em> (you don’t need them for now) with <em>override</em> (you need them to select elements and style them on the page):</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b7383e8327366a7753f6c09b8d1eb604/href">https://medium.com/media/b7383e8327366a7753f6c09b8d1eb604/href</a></iframe><p>with</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/ee50ff43fc80d5f2af4e06b72a607a48/href">https://medium.com/media/ee50ff43fc80d5f2af4e06b72a607a48/href</a></iframe><p>6. Add a call to the<em> useState</em> hook below that will monitor the state:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/1be0864affa583a890f4aa32a28f443f/href">https://medium.com/media/1be0864affa583a890f4aa32a28f443f/href</a></iframe><p>7. Then add the <em>useEffect </em>hook that will make queries to the Airtable API and put the received data into the state through the <em>setEmployees </em>function.</p><p>Add here the lines that you copied earlier. Add the URL of the database and the <em>?view=All%20employees</em> parameter to <em>fetch</em>. Add the authorization parameters and the API key (that you generated in Part 3 step 4 of this article) to <em>headers</em>.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/dc9fa2f28ab39c1333e13e8897b2b77a/href">https://medium.com/media/dc9fa2f28ab39c1333e13e8897b2b77a/href</a></iframe><p>8. Now generate cards with the received data by transferring <em>props</em> to them with data and <em>override</em>. You need it to select and style elements on the page.</p><p>Replace:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/ce36103d2018d25d8c384c0e76e03351/href">https://medium.com/media/ce36103d2018d25d8c384c0e76e03351/href</a></iframe><p>with</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c718dc41fdfa71f0e67f0586971f3f58/href">https://medium.com/media/c718dc41fdfa71f0e67f0586971f3f58/href</a></iframe><p>9. Press Ctrl + S (or Cmd + S on Mac). The final code should look like this:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/20ba1d8de96cc6395dc2522ae3f6c244/href">https://medium.com/media/20ba1d8de96cc6395dc2522ae3f6c244/href</a></iframe><p><strong>Important</strong>: don’t forget to paste your unique API key instead of “YOUR_API_KEY”.</p><p>Ready! Now get the data from Airtable, put it in <em>employees,</em> and apply the <em>map </em>method to it. For each employee record, create an <em>&lt;EmployeeCard/&gt;</em> where we send specific data as props.</p><p>Now let’s configure <em>EmpolyeeCard</em> to accept this data and show it in the right place.</p><h3>Part 5. Make EmployeeCard work with the database</h3><p>In this stage, you will configure the employee card to accept data and display it.</p><p>1. Open the component code. To do this, go to the “Components”<em> </em>tab, find <em>EmployeeCard</em>, mouse over it, and click on the “&lt;&gt;” item.</p><p>2. Now the component code looks like this:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5f728b8b8dbfb76a4e8b5f1317881c5c/href">https://medium.com/media/5f728b8b8dbfb76a4e8b5f1317881c5c/href</a></iframe><p>3. Find this line:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/953b772f46bba59e24ba035b3ad3ab0b/href">https://medium.com/media/953b772f46bba59e24ba035b3ad3ab0b/href</a></iframe><p>And paste it below:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/dccab17e31b0621bf1f3f55f60386fee/href">https://medium.com/media/dccab17e31b0621bf1f3f55f60386fee/href</a></iframe><p>The data is added to the <em>employee </em>item.</p><p>4. Using the employee’s photo as an example, let’s check if everything works as expected. Find this line and replace it:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b91352ef67edaf6a106e4c535cb4acfc/href">https://medium.com/media/b91352ef67edaf6a106e4c535cb4acfc/href</a></iframe><p>with</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5caa06c4a9e86ec90e46b0889f47a668/href">https://medium.com/media/5caa06c4a9e86ec90e46b0889f47a668/href</a></iframe><p>Find this:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/cf8242ded3304f6f5339bfde29163383/href">https://medium.com/media/cf8242ded3304f6f5339bfde29163383/href</a></iframe><p>and replace with</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/d778cbcb5bfd691291f1336e65d69997/href">https://medium.com/media/d778cbcb5bfd691291f1336e65d69997/href</a></iframe><p>This is how the final result should look:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XIgUS9mhz7mkdcowz8kowg.png" /></figure><p>5. Let’s see what fields we have. The API documentation is done very well on Airtable. You can find the field names on <a href="https://airtable.com/api">https://airtable.com/api</a> by selecting your base.</p><p>Find the “EMPLOYEE DIRECTORY TABLE” section.</p><p>So, we have:</p><blockquote>Name<br>Department<br>Home address<br>Email address<br>DOB<br>Start date<br>Phone<br>Reports to<br>Title<br>Status<br>Photo<br>Location</blockquote><p>6. AddTitle. To do this, replace</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/959c360f2a53a7f738f84d90a0ee1559/href">https://medium.com/media/959c360f2a53a7f738f84d90a0ee1559/href</a></iframe><p>with</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/540d63dc3a974763a6167bc99c5f8aa8/href">https://medium.com/media/540d63dc3a974763a6167bc99c5f8aa8/href</a></iframe><p>Don’t forget to edit the <em>overrides</em> of this component so that you can select and edit it on the page.</p><p>Replace:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/4729e004dcebd17bb38f079babe2032d/href">https://medium.com/media/4729e004dcebd17bb38f079babe2032d/href</a></iframe><p>with</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/11ca324181db59fdc0a73b8bdf1ba329/href">https://medium.com/media/11ca324181db59fdc0a73b8bdf1ba329/href</a></iframe><p>Save and check:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-lHJSjlpZCkmwrIpNN2vdA.png" /></figure><p>The result: a line with the job title was added to the cards.</p><p>7. Repeat the same actions for <em>Name</em> and <em>Home address.</em></p><p>Replace</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3d42e3a5c40dcbdfadab70efcb9bb502/href">https://medium.com/media/3d42e3a5c40dcbdfadab70efcb9bb502/href</a></iframe><p>with</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/9961db7a109ca1ac9e6bdd7702e9f87f/href">https://medium.com/media/9961db7a109ca1ac9e6bdd7702e9f87f/href</a></iframe><p>And change their <em>overrides</em>. To do this, replace</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/ececd6208bd2070430ae5472b5bed02a/href">https://medium.com/media/ececd6208bd2070430ae5472b5bed02a/href</a></iframe><p>with</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/10a46cb6559bc43d1753026308b280ac/href">https://medium.com/media/10a46cb6559bc43d1753026308b280ac/href</a></iframe><p>Save and check:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*x8FxYQuQeJmE19TgXR9y4Q.png" /></figure><p>8. Add some more <em>Text </em>in the same way. Let’s leave <em>Department </em>and <em>Reports to</em> because this data is in another “DEPARTMENTS TABLE” database.</p><p>Add:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/ca7b2e4708450db3567943c15ed50477/href">https://medium.com/media/ca7b2e4708450db3567943c15ed50477/href</a></iframe><p>and</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/875aa1f3d71de651cd6766b6871b3955/href">https://medium.com/media/875aa1f3d71de651cd6766b6871b3955/href</a></iframe><p>This is the final result:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-rZ86wTkDfizfoHZaH8FNA.png" /></figure><p>9. Now add to <em>Link </em>components where you will create <em>Phone</em> and <em>Email</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/9828105d42968b5fb5ed6b871704426a/href">https://medium.com/media/9828105d42968b5fb5ed6b871704426a/href</a></iframe><p>replace with:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/80a840c742047c8dc1bd53e66443876b/href">https://medium.com/media/80a840c742047c8dc1bd53e66443876b/href</a></iframe><p>And add these lines:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/fc921c6c17d009df27bc40123444a6d7/href">https://medium.com/media/fc921c6c17d009df27bc40123444a6d7/href</a></iframe><p>Don’t forget about their <em>overrides</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/14d5fe60cad5db254ca21be0932caa76/href">https://medium.com/media/14d5fe60cad5db254ca21be0932caa76/href</a></iframe><p>Check the result:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*v3xr8yycMb8MCPgUsVQAeg.png" /></figure><p>This is the final code:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/32b2100a22120943b062aa8a525ea143/href">https://medium.com/media/32b2100a22120943b062aa8a525ea143/href</a></iframe><p>Commit to GitHub and publish on Netlify:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pyLT6Dd2cJUDeD0YkVS83Q.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YrOWETDI_d7i-52n_uIcKg.png" /></figure><p>Wait a few minutes and check: <a href="https://keen-varahamihira-c54ae1.netlify.app/">https://keen-varahamihira-c54ae1.netlify.app/</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dkcxQcMhtp6R8bbFztiV_A.png" /></figure><p>To check synchronization, change the data in the database:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CjO1lfhf09D3-I0Q7wWKGg.png" /></figure><p>Now you will see the changes in the app:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*aiXXJqDpBs0NSHKlTejPqw.png" /></figure><p>In the future, you will be able to style your card elements, however you want to do this without breaking the configured import from Airtable. You can see an example <a href="https://youtu.be/mbPukPi0RZA?t=489">here</a>.</p><p>GitHub repository: <a href="https://github.com/quarkly-dev/Getting-data-from-Airtable-tutorial">https://github.com/quarkly-dev/Getting-data-from-Airtable-tutorial</a></p><p>Thanks for reading!</p><p>If you still have questions, feel free to ask them in the comments below. In the next tutorial, we’ll have a look at another example of working with data and show how to design it interactively allowing the user to change the filters directly in the app.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=12f51b7e4bc4" width="1" height="1" alt=""><hr><p><a href="https://medium.com/swlh/creating-an-app-with-a-staff-base-in-react-using-airtable-and-quarkly-12f51b7e4bc4">Creating an App with a Staff Base in React using Airtable and Quarkly</a> was originally published in <a href="https://medium.com/swlh">The Startup</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Quarkly is Looking for a Product Evangelist]]></title>
            <link>https://medium.com/quarkly/quarkly-is-looking-for-a-product-evangelist-2842764a5473?source=rss-5a286a497196------2</link>
            <guid isPermaLink="false">https://medium.com/p/2842764a5473</guid>
            <category><![CDATA[reactjs]]></category>
            <category><![CDATA[react]]></category>
            <category><![CDATA[social-media]]></category>
            <category><![CDATA[marketing]]></category>
            <category><![CDATA[javascript]]></category>
            <dc:creator><![CDATA[Alex]]></dc:creator>
            <pubDate>Wed, 24 Jun 2020 14:40:09 GMT</pubDate>
            <atom:updated>2020-06-24T14:40:09.127Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EkGZUbr6F9QrKvIPh2mb3Q.png" /></figure><p><a href="https://quarkly.io/"><em>Quarkly</em></a><em> is a unique design tool for creating React based websites and web apps</em><strong><em>. </em></strong><em>It is designed for webmasters, designers, and developers.</em></p><p><em>Here you can create websites as quickly as in website builders and as beautifully as in graphic editors.</em></p><h4><strong>Why are we called Quarkly?</strong></h4><p>Just as in physics where the smallest elements — quarks — build up an atom, with Quarkly, you can manipulate the smallest elements and edit code on the most fundamental level to build an amazing website.</p><blockquote>We are looking for a rock-star evangelist to build and grow Quarkly’s communities, cultivate product awareness, and educate followers on its latest updates and releases.</blockquote><h4><strong>You will:</strong></h4><ul><li>Generate and share content to build Quarkly’s reputation as a leading web design tool.</li><li>Actively participate in Quarkly’s online communities.</li><li>Cultivate awareness of Quarkly’s product within relevant communities of designers and front-end developers.</li><li>Collaborate with Quarkly’s product and marketing teams.</li></ul><h4><strong>Requirements:</strong></h4><ul><li>You have extensive knowledge of front end/web design and have an interest in developing content focused around this.</li><li>You already are an active member of the front-end, web or language communities in your region.</li><li>You have a strong following on social media or online professional communities</li><li>You are able to transform dry technical topics into engaging, informative, and interesting educational materials.</li></ul><p>Quarkly is going to revolutionize the way websites, and apps are created.</p><p>Join us on this journey!</p><p>To apply, email <a href="/service/mailto:pr@quarkly.io">pr@quarkly.io</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2842764a5473" width="1" height="1" alt=""><hr><p><a href="https://medium.com/quarkly/quarkly-is-looking-for-a-product-evangelist-2842764a5473">Quarkly is Looking for a Product Evangelist</a> was originally published in <a href="https://medium.com/quarkly">Quarkly</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Why We Gave Up on the Idea of Using Styled System to Create Components]]></title>
            <link>https://medium.com/quarkly/why-we-gave-up-on-the-idea-of-using-styled-system-to-create-components-fb65012e063f?source=rss-5a286a497196------2</link>
            <guid isPermaLink="false">https://medium.com/p/fb65012e063f</guid>
            <category><![CDATA[css-in-js]]></category>
            <category><![CDATA[reactjs]]></category>
            <category><![CDATA[styled-components]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[react]]></category>
            <dc:creator><![CDATA[Alex]]></dc:creator>
            <pubDate>Tue, 16 Jun 2020 15:26:47 GMT</pubDate>
            <atom:updated>2020-06-16T15:26:47.478Z</atom:updated>
            <content:encoded><![CDATA[<p>Hi everyone! My name is Alex. I’m one of the founders and lead developer at <a href="https://quarkly.io/">Quarkly</a>. In this post, I’d like to share with you how the concept of atomic CSS, which we follow, together with the disadvantages of <em>styled-system</em> functionality (and <em>rebass</em> in particular) inspired us to create our own tool that we call Atomize.</p><h4>A Few Words About Us</h4><p>Our Quarkly project is a mix of a graphic editor (like Figma and Sketch) and website builder (similar to Webflow), complemented by features of traditional IDE. We’ll be sure to elaborate on Quarkly in a separate post, as there is plenty to tell and show, but today we’ll focus on the details of the Atomize tool.</p><p>Atomize is the heart of the whole project, as it allows us to solve tasks that would be difficult or even impossible to handle using <em>styled-system</em> and <em>rebass</em>. At the very least, the latter solution is much less elegant.</p><p>If you don’t have time to read the entire post now, check out a brief description of Atomize on our <a href="https://github.com/quarkly/atomize">GitHub</a>.</p><h4>How It All Started</h4><p>When we got down to developing this tool, our team’s task was to give users the opportunity to code on two components, but without the need to have a separate CSS file. This was to keep the code as minimalistic as possible while retaining all CSS features in contrast to inline styles.</p><p>The task was far from ground-breaking and, at first sight, could be easily solved with the help of <em>styled-system</em> (and <em>rebass</em>). But its functionality turned out to be limited for us. Or rather, we ran into the following problems:</p><ul><li>inconvenient breakpoints</li><li>no option to write styles for <em>hover</em>, <em>focus</em>, and other behaviors</li><li>mechanism for working with themes wasn’t as flexible as we needed</li></ul><h4>Briefly About Atomize</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*drB8hqTuN2jNqRUiyZL00w.png" /></figure><h4>Here are the key Atomize features:</h4><ul><li>option to use variables from the theme in composite CSS properties</li><li>support for <em>hover</em> and any other pseudo-classes</li><li>short aliases for each property (like in <em>emmet</em>)</li><li>opportunity to set styles for a specific breakpoint, all while keeping the markup readable</li><li>minimalistic interface</li></ul><p>That being said, Atomize is intended for two main purposes:</p><ul><li>creation of components that support atomic CSS and themes</li><li>creation of widgets for the interactive editing in the Quarkly project</li></ul><h4>Atomize. A User Manual</h4><p>Before you start working with Atomize, you need to set up dependencies:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/46ed7b22c7a236458813606cd25fd239/href">https://medium.com/media/46ed7b22c7a236458813606cd25fd239/href</a></iframe><p>Atomize serves as a wrapper around a <em>styled-component</em> and has a similar API. Just call the method using the name of the required element:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/15119433335d40d1b6622c11dcb9e4c0/href">https://medium.com/media/15119433335d40d1b6622c11dcb9e4c0/href</a></iframe><p>As a result, we get the React component that can take any CSS in the form of properties.</p><p>To make it easier to use, we developed the system of alias properties. For example, <em>bgc === backgroundColor.</em></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/18f992ea5ffbccb5bb8e04b06559f167/href">https://medium.com/media/18f992ea5ffbccb5bb8e04b06559f167/href</a></iframe><p>To see the full list of properties and aliases, follow this <a href="https://github.com/quarkly/elementary/blob/master/docs/props.md">link</a>.</p><p>Plus, we added the mechanism of inheritance in React:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/f8114556e0ab40d98b820a84c5c816b3/href">https://medium.com/media/f8114556e0ab40d98b820a84c5c816b3/href</a></iframe><h4>Themes</h4><p>This, I think, should be explained in more detail.</p><p>Quarkly themes are based on CSS variables. The key feature of Quarkly themes is that variables from themes can be reused both in props and themes. You don’t need to use additional abstractions, like template functions, and no additional editing is needed by the user.</p><p>To use variables from a theme, just describe the property in the theme and call this property using the prefix “ — “.</p><p>The variables can be used both in JSX:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5344401eff0cfa0064d957e618a45568/href">https://medium.com/media/5344401eff0cfa0064d957e618a45568/href</a></iframe><p>And in the theme itself:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b05de281c82a8e22cc42794b535d1f6d/href">https://medium.com/media/b05de281c82a8e22cc42794b535d1f6d/href</a></iframe><p>The shorter syntax is used for colors in the JSX markup:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/eb7ba4a822602c05904fb3231b461840/href">https://medium.com/media/eb7ba4a822602c05904fb3231b461840/href</a></iframe><p>Themes have breakpoints for working with media expressions.</p><p>Any property can be prefixed with a breakpoint key name.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3086c765588f19e916dfcc9f011254d9/href">https://medium.com/media/3086c765588f19e916dfcc9f011254d9/href</a></iframe><p>You can find the source code <a href="https://github.com/quarkly/theme">here</a>.</p><h4>Effects</h4><p>The main difference between Atomize and the <em>styled system</em> is the “effects”.</p><p>What are they and why do you need them?</p><p>Well, imagine you create a <em>Button </em>component, change its <em>color</em> and <em>border</em> and then… you realize you don’t know how to assign styles to <em>hover</em>, <em>focus,</em> etc. This is where effects come to the rescue.</p><p>When creating a component, just transfer an object with the configuration:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2b7e73415d0c89dfe9500204e2221deb/href">https://medium.com/media/2b7e73415d0c89dfe9500204e2221deb/href</a></iframe><p>The key is the prefix in the name of the property, and the value is a CSS selector. This is the same way we implemented pseudo-classes.</p><p>Now, if you specify the <em>hover</em> prefix for any CSS property, it will be applied to a certain effect. For example, when you mouse over it:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/9b2155a43b621bf466257b7210b60bf4/href">https://medium.com/media/9b2155a43b621bf466257b7210b60bf4/href</a></iframe><p>You can also combine effects with media expressions:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/81243f406521d9698a18d3934b83a013/href">https://medium.com/media/81243f406521d9698a18d3934b83a013/href</a></iframe><h4>A Few Examples</h4><p>Let’s build several interesting components to illustrate the features I’ve described above.</p><p>Here are two examples:</p><ul><li><a href="https://codesandbox.io/s/atomize-demo-skhjw?file=/src/Example.js">a simple component that shows all the capabilities of the library</a></li><li><a href="https://codesandbox.io/s/pokemon-card-atomize-9pwom?file=/src/App.js">a more complex example with a Pokémon card</a></li></ul><p>Everybody loves Pokémon, don’t they? :)</p><h4>Wait! There’s More</h4><p>The second purpose of Atomize, as I mentioned above, is to create widgets in Quarkly based on custom React components.</p><p>All you have to do is wrap your component in Atomize and describe its configuration so that Quarkly can understand which properties can be interactively edited:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/4c3bea1812f9b0b22cbda6ab81796faa/href">https://medium.com/media/4c3bea1812f9b0b22cbda6ab81796faa/href</a></iframe><p>The configuration fields for the component look like this:</p><ul><li><em>effects</em> — defines browser pseudo-classes (<em>hover, focus, etc.</em>)</li><li><em>description</em> — component description that will appear when you mouse over its name</li><li><em>propInfo</em> — configuration of controls that will be displayed on the right panel (Props tab)</li></ul><p>How to specify the props to be displayed on the right panel (Props tab):</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/9167f149bed3b2dd209cc62fa28622d6/href">https://medium.com/media/9167f149bed3b2dd209cc62fa28622d6/href</a></iframe><p>Possible control options:</p><ul><li>input</li><li>select</li><li>color</li><li>font</li><li>shadow</li><li>transition</li><li>transform</li><li>filter</li><li>background</li><li>checkbox-icon</li><li>radio-icon</li><li>radio-group</li><li>checkbox</li></ul><p>One more example, where we’ve added our custom component to the system and can now edit it interactively:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FBzkV_g_q84U%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DBzkV_g_q84U&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FBzkV_g_q84U%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/3e5e835849180dbc023204e98d95cb8d/href">https://medium.com/media/3e5e835849180dbc023204e98d95cb8d/href</a></iframe><p>Yay! You’ve made it to the end :) Thanks for reading!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=fb65012e063f" width="1" height="1" alt=""><hr><p><a href="https://medium.com/quarkly/why-we-gave-up-on-the-idea-of-using-styled-system-to-create-components-fb65012e063f">Why We Gave Up on the Idea of Using Styled System to Create Components</a> was originally published in <a href="https://medium.com/quarkly">Quarkly</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>