Skip to content
This repository has been archived by the owner on Oct 3, 2023. It is now read-only.

Miru icons docs #20

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions docs/contributing-guide/icons/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"label": "Miru Icons",
"position": 4,
"collapsed": true,
"link": {
"type": "generated-index",
"description": "How to use and update Miru Icons"
}
}
104 changes: 104 additions & 0 deletions docs/contributing-guide/icons/list.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
---
id: iconslist
title: List of Icons
---

## Guide contains the list of all available Miru icons

```
WarningTriangleSVG
WarningCloseIconSVG
UserAvatarSVG
VisaSVG
SuccessSVG
ClickSuccessSVG
StripeLogoSVG
ShieldSVG
Setting_iconSVG
SaveButtonSVG
SearchIconSVG
SaelounLogoSVG
SConnectInvoiceSVG
PlusIconSVG
PasswordIconTextSVG
PasswordIconSVG
NotificationSVG
MiruLogoWithTextSVG
MobileSVG
PConnectInvoiceSVG
MasterCardSVG
LogoutIconSVG
LogoSVG
CloseInfoSVG
HelpIconSVG
CircleInfoSVG
GoogleSVG
ErrorOctagonSVG
EditImageButtonSVG
EditSVG
DownArrowSVG
DownSVG
DeleteImageButtonSVG
CloseButtonSVG
CompanySVG
ConnectedCheckSVG
CheckedCheckboxSVG
CancelButtonSVG
UncheckedCheckboxSVG
AvatarPaymentsSVG
AvatarSVG
ApplePaySVG
AppleSVG
PaypalDropdownSVG
PaypalLogoSVG
PurpleMiruLogoWithTextSVG
StripeDropdownSVG
TwitterSVG
AlertSVG
AmexSVG
NavAvatarSVG
InstagramSVG
WaiveSVG
MiruWhiteLogoWithTextSVG
ConnectPaypalSVG
ConnectSVG
ConnectMobileSVG
disconnectAccountSVG
MiruLogoSVG
MiruLogoWatermarkSVG
DeleteIconSVG
ReportcalendarIcon
CalendarHoverIcon
HoursIcon
HoursHoverIcon
OverdueOutstandingIcon
OverdueOutstandingHoverIcon
RevenueIcon
RevenueHoverIcon
AccountsAgingIcon
AccountsAgingHoverIcon
Switcher
EmptyState
NoSearchResultsState
BlurredMiruLogo
TransparentMiruLogo
MiruTimeTrackingScreen
MiruReportAndAnalysisScreen
MiruPaymentAndInvoicesScreen
MiruManagingProjectsScreen
MiruManagingClientsScreen
MiruManagingEmployeesScreen
MoreOptionIcon
GreenCheckCirleIcon
deleteImageIcon
Animation_404
GoogleCalendarIcon
VacationIconSVG
BabyIconSVG
CakeIconSVG
FlowerIconSVG
CarIconSVG
UserIconSVG
CalendarBlackIconSVG
MedicineIconSVG
```
60 changes: 60 additions & 0 deletions docs/contributing-guide/icons/miruicons.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
id: miruicons
title: Miru Icons
---

## A Guide to Using Icons in the App and Adding New Icons

Icons play a crucial role in user interface (UI) design, offering visual cues that enhance user experience and navigation. However, managing a consistent set of icons across app can be challenging.

MiruIcons, a solution designed to simplify icon management, promote UI consistency, and save development time. In this guide, we'll explore how to use MiruIcons and even how to add new icons when they are not yet available in the collection.

#### What Are MiruIcons?
MiruIcons is a comprehensive collection of reusable icons tailored for your app's needs. This collection includes a mix of icons, ranging from popular third-party icons to custom-designed ones. By centralizing icons in one place, MiruIcons ensures that our app maintains a cohesive and consistent visual identity.

#### Benefits of Using MiruIcons
- **UI Consistency:** MiruIcons enforces a unified style, preventing the use of disparate icons across our app.
- **Reuse and Efficiency:** Developers can easily import and reuse icons, reducing the need to create icons from scratch.
- **Scalability:** As our app grows, MiruIcons can expand to accommodate new icons seamlessly.

### Using MiruIcons

#### Importing MiruIcons
To get started with MiruIcons, you'll need to import the icons into components. The following examples demonstrate how to do this:

```
import { CaretCircleLeftIcon } from "miruIcons";
import { SearchIcon } from "miruIcons";
import { XIcon } from "miruIcons";
```

#### Importing Multiple Icons

```
import { PencilIcon, DeleteIcon } from "miruIcons";
import { SearchIcon, FilterIcon } from "miruIcons";
```

### Adding New Icons to MiruIcons

One of the strengths of MiruIcons is its flexibility. If you need an icon that isn't already in the collection, you can easily add it. Follow these steps:

- **Step 1: Prepare the Icon File**
Before adding a new icon, you'll need the icon's SVG file or import it from `phosphor-react` package or you can even add gif file. Basically you can create your own or obtain one that suits your needs. Ensure the file adheres to any format or dimension requirements.

- **Step 2: Add the Icon to the MiruIcons Folder**
Next, place the newly acquired icon file in the appropriate MiruIcons folder. It's essential to maintain a structured hierarchy for icons to keep things organized.
Export the newly added icon from the `index.tsx` file of MiruIcons.

-- **Step 3: Import and Use the New Icon**
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It will render '--' instead of a bullet point.

With the icon file in place, you can import and use it just like any other MiruIcon:

```
import { NewCustomIcon } from "miruIcons";
```

Congratulations! You've successfully added a new icon to MiruIcons.


### Conclusion
MiruIcons simplifies the process of managing icons in our app, offering both existing icons for consistency and an easy way to add new ones. By following the steps outlined in this guide, you can enhance our app's UI while maintaining a cohesive design.