# Introduction 👋

[![Typed with TypeScript](https://camo.githubusercontent.com/69ea44e002591f4d18f9d1ee7660e8c49bbf4e673405eb058e3af515a193d376/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f69636f6e2f54797065643f69636f6e3d74797065736372697074266c6162656c266c6162656c436f6c6f723d626c756526636f6c6f723d353535353535)](https://camo.githubusercontent.com/69ea44e002591f4d18f9d1ee7660e8c49bbf4e673405eb058e3af515a193d376/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f69636f6e2f54797065643f69636f6e3d74797065736372697074266c6162656c266c6162656c436f6c6f723d626c756526636f6c6f723d353535353535)

**No cruft. No bloat. No dependencies.**

**Common Utilities** is an ecosystem of simple utility JavaScript functions for everyday development. 

### Hello! 🙌

**This project is built to provide JavaScript utility functions that are:**

* Easy to use 😌
* Simple 👌
* Tested ✅
* Typed (using Typescript) 📝
* Example containing 📚
* Collaborative 🎳

Just because this repository is currently under [**@yowainwright**](https://github.com/yowainwright) on Github. It can be moved to a **Github org** if others get involved! Please give **Common Utilities** a [**star on Github**](https://github.com/yowainwright/common-utilities), share, or give feedback if the documentation or packages themselves help you or need improvement!

### Why? 🤔

Often engineers write simple functions to do simple things. There is always an option to reach for a heavier tool to do something like a **deep merge**. However, often engineers can do something **simple** to satisfy their use-case. \
\
**Common Utilities** aims to provide functions for the **simple** use-case described above but with **types** and **tests**. This means engineers can use a smaller function from Common Utilities that looks much like something they would write quickly but not need to write tests or types because Common Utilities provides those things. Inversely, using a utility function from Common Utilities adds very little extra bloat for each utility used. 

### Common Utilities 🧰

**No cruft. No bloat. No dependencies.**

Simple, typed, functional, documented, and tested javascript utility functions.

View other [**common utilities**](https://github.com/yowainwright/common-utilities) on Github.