# ๐งฉ Tiny Essentials
**Tiny Essentials** is a collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.
## โจ Features
Tiny Essentials provides a wide range of utilities โ from array manipulations and time calculations to object helpers and custom tools.
For the **full list of features and usage examples**, please check the [documentation](./docs).
## ๐ฆ Installation
You can install Tiny Essentials via npm:
```bash
npm install tiny-essentials
```
Or download the scripts directly from this repository.
## ๐งช Module Versions
The core version of Tiny Essentials (version 1) is located in the folder [`/src/v1`](./src/v1).
A detailed README is available inside the [`v1`](./src/v1) folder, which contains a full description of all utility modules and their functionalities.
We recommend checking it out if you want to see all available tools in this version and how to use them individually or collectively via the `index.mjs` global module.
## ๐ Documentation
Looking for detailed module explanations and usage examples?
Check out the full documentation here:
๐ [Go to docs page](./docs/v1/README.md)
---
## ๐ฆ More Tiny Essentials Modules
- ๐ค [**tiny-ai-api**](https://github.com/Tiny-Essentials/Tiny-AI-API) โ Minimal AI API wrapper.
- ๐ฒ [**tiny-dices**](https://github.com/Tiny-Essentials/Tiny-Dices) โ Simple dice and randomness utilities.
- ๐ [**tiny-crypto-suite**](https://github.com/Tiny-Essentials/Tiny-Crypto-Suite) โ Lightweight cryptography toolkit.
- ๐ฅ๏ธ [**tiny-server-essentials**](https://github.com/Tiny-Essentials/Tiny-Server-Essentials) โ Node.js server utilities.
- ๐ช [**tiny-electron-essentials**](https://github.com/Tiny-Essentials/Tiny-Electron-Essentials) โ Essential tools for Electron apps.
- ๐๏ธ [**puddysql**](https://github.com/Tiny-Essentials/PuddySQL) โ Smart SQL engine for structured data, tags, and advanced queries.
- ๐ข [**my-tiny-events**](https://github.com/Tiny-Essentials/My-Tiny-Events) โ A event emitter system for JavaScript, inspired by Node.js EventEmitter with support for multi-event handling and listener management.
---
### ๐ง Recommended Tool: **JsStore**
Although not part of Tiny Essentials, we recommend using [**JsStore**](https://www.npmjs.com/package/jsstore) if you're looking for a well-maintained and developer-friendly solution to interact with **IndexedDB** using SQL-like syntax.
> ๐ฌ *This is a personal recommendation. This project is not sponsored or affiliated with JsStore.*
---
## ๐๏ธ Legacy Code
The scripts previously maintained in this repository have been migrated to the following location:
๐ https://github.com/Tiny-Essentials/Tiny-Essentials-Legacy
This includes modules such as:
- `@tinypudding/firebase-lib`
- `@tinypudding/discord-oauth2`
- `@tinypudding/mysql-connector`
- `@tinypudding/puddy-lib`
These modules are preserved for backwards compatibility and may not receive further active development.
---
## ๐ค Contributions
Feel free to fork, contribute, and create pull requests for improvements! Whether it's a bug fix or an additional feature, contributions are always welcome.
## ๐ License
This project is licensed under the LGPL-3.0 License - see the [LICENSE](LICENSE) file for details.
### ๐ก Credits
This project was inspired by the need for lightweight, reusable code that can be used across many different kinds of applications. Contributions and suggestions are always appreciated!
> ๐ง **Note**: This documentation was written by [ChatGPT](https://openai.com/chatgpt) and [Gemini](https://gemini.google.com), AI assistants developed by OpenAI and Google, based on the project structure and descriptions provided by the repository author.
> If you find any inaccuracies or need improvements, feel free to contribute or open an issue!
---
Made with tiny love!
