npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@deriv/quill-icons

v2.2.0

Published

This is the central repository for quill icons, exported from figma design file

Downloads

7,418

Readme

Deriv Quill Icons

npm

Explore and integrate the complete set of icons from Deriv with easy-to-use React components. These icons are exported from a Figma Icon project.

The motivation of creating this library

We developed the Deriv Quill Icons library to address several critical considerations across our projects:

  1. Consistency across all of our projects: By creating Deriv Quill Icons we ensure a consistent design language across all of our applications. All icons will have a similar style, size, and color.
  2. Easy Maintenance: Managing all of the icons in a centralised library makes it easier to update or modify them. If we decide to change the design or add new icons, we only need to make changes in one place, and the updates will be reflected throughout all of our applications.
  3. Reuse and Efficiency: We can easily reuse the same set of icons across different components and pages in our applications. This promotes code reusability and reduces redundancy, as we don't have to duplicate icon assets or styles.
  4. Customisation: It allows us to customise our icons globally. For example, we can change the color scheme, size, or other visual aspects of all icons in one place without modifying individual components. Also we can easily apply optimisations to all of our icons in one place.
  5. Developer Productivity: It enhances our developer productivity. Developers can easily find and use the icons they need without having to search for or create new assets each time.

and ...

Installation

npm i @deriv/quill-icons

Usage

import { CurrencyAlgoIcon } from '@deriv/quill-icons';

const TestComponent = () => (
  <h3>
    Lets go for a <CurrencyAlgoIcon />?
  </h3>
);

Contribution Guidelines

Prerequisite

We use @figma-export to export Figma Components so Please read their docs and try to get comfortable with their concepts.

With @figma-export we export to handle SVG creation for each Figma Component and then with transform-svg-with-svgo we optimize the exported SVGs. this is a transformer and you can add/remove/update SVG attributes with it.

Outputters

Pre-installation

  • node >=16.16.0
  • npm >=7.21.0
  • git (for contribution)
  • Figma Token (Check This to set it up for yourself)
  • Figma File ID
  • Figma icons page

Quick start

  1. Enter the project directory

    cd quill-icons
  2. Create a .env file inside quill-icons folder with this content:

    FIGMA_TOKEN=your_figma_access_token
  3. Install your dependencies:

    npm ci
  4. Export:

    npm run export

Icons Naming Conventions

In the Quill Design System, we utilise naming conventions to store and locate components in their respective groups easily. The naming conventions differ slightly between Quill Icons, Quill Logos and Quill Illustrations. This is to cater specifically to their specific needs.

Quill Icons: [Category name] / [Size] / [Icon name] / [Style]

  • "Category name" refers to the broad number of categories the icons reside in—such as currency, flag, and market icons.
  • (Only if applicable) The "Size" part of the naming convention is only added when the icons are provided in multiple different sizes.
  • "Icon name" is the distinct name for each icon that differentiates one icon from another.
  • (Only if applicable) Applied to icons that have variations—such as regular/bold and white/black.

Examples of icons using this naming convention:

  1. illustrative / md / derived-md = [Category name] / [Size] / [Icon name]
  2. flags / flag-malysia = [Category name] / [Icon name]
  3. standalone / sm / grips-dots-vertical-sm / regular = [Category name] / [Size] / [Icon name] / [Style]

Quill Logos : [Category name] / [Subcategory name] / [Logo name] / [Style]

  • "Category name" refers to the general category that encapsulates all logos, hence, the name "logo".
  • "Subcategory name" refers to the specific categories that further divide logos into—such as brands, sub-brands, and payment methods.
  • "Logo name" is the distinct name for each logo that differentiates one logo from another.
  • "Styles" are variations of the logo, in terms of colour, alignment, etc.

Examples of logos using this naming convention:

  1. logo / brand / deriv-wordmark / coral = [Category name] / [Subcategory name] / [Logo name] / [Style]
  2. logo / payment method / visa / brand = [Category name] / [Subcategory name] / [Logo name] / [Style]

Quill Illustration : [Category name] / [Subcategory name] / [Style] / [Illustration name]

  • "Category name" refers to the general category that encapsulates all illustrations, hence, the name "illustration".
  • "Subcategory name" refers to the specific categories that further divide illustrations into.
  • "Styles" are variations of the illustration, in terms of colour, theme, etc.
  • "Illustration name" is the distinct name for each illustration that differentiates one illustration from another.

Examples of illustrations using this naming convention:

  1. illustration / deriv / light / pairs = [Category name] / [Subcategory name] / [Style] / [Illustration name]
  2. illustration / deriv / light / ic-cashier-locked = [Category name] / [Subcategory name] / [Style] / [Illustration name]
  3. illustration / deriv / dark / positions-history = [Category name] / [Subcategory name] / [Style] / [Illustration name]

Exporting New Icons

To export new icons, run npm run rebuild. It will automatically export, optimize, and convert SVGs to React components. Afterward, just commit the changes and create a new PR.

Build and Publish

We use semantic-release for automating the release workflow. Commit messages determine the release type. Refer to the table below for guidelines.

| Commit message | Release type | | ----------------------------------- | --------------------------- | | build, ci, chore, docs, style, test | Patch (Fix Release) | | refactor | Minor (Feature Release) |

Triggering a release

For each new commit added to one of the release branches (for example: main, next, beta), with git push or by merging a pull request or merging from another branch, a CI build is triggered and runs the semantic-release command to make a release if there are codebase changes since the last release that affect the package functionalities.

For further information please checkout the semantic-release documentation.