# NPM Library

## 📦 What is discloud.app?

**discloud.app** is the official **Node.js** library for interacting with the **Discloud API**. This powerful library allows you to programmatically manage your applications, perform uploads, monitor status, control app lifecycle, and much more, all from your JavaScript or TypeScript projects.

## ✨ Key Features

<table data-column-title-hidden data-view="cards"><thead><tr><th align="center"></th><th align="center"></th></tr></thead><tbody><tr><td align="center"><strong>🚀 Application Management</strong></td><td align="center">Upload, update, start, stop, restart, and delete your applications with simple API calls.</td></tr><tr><td align="center"><strong>📊 Real-time Monitoring</strong></td><td align="center">Get application status, view logs, check resource usage, and monitor performance metrics.</td></tr><tr><td align="center"><strong>👥 Team Management</strong></td><td align="center">Manage application moderators, permissions, and collaborative access controls.</td></tr><tr><td align="center"><strong>⚙️ Advanced Configuration</strong></td><td align="center">Handle RAM allocation, APT packages, environment variables, and custom settings.</td></tr><tr><td align="center"><strong>📁 File Operations</strong></td><td align="center">Support for multiple file formats including streams, buffers, and direct file paths.</td></tr><tr><td align="center"><strong>🔒 Secure Authentication</strong></td><td align="center">Built-in token management and secure API communication with error handling.</td></tr></tbody></table>

## 🔗 Useful Links

* **📖** [**API Documentation**](https://docs.discloud.com/en/api-and-integrations/api-overview) - Complete TypeDoc documentation
* **🐙** [**GitHub Repository**](https://github.com/discloud/discloud.app) - Source code and issues
* **📦** [**NPM Package**](https://www.npmjs.com/package/discloud.app) - Download and version info

## 🚀 Quick Start

Ready to get started? Check out our comprehensive guides:

<table data-card-size="large" data-view="cards"><thead><tr><th data-card-target data-type="content-ref"></th><th align="center"></th><th data-hidden></th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td><a href="npm-library/getting-started">getting-started</a></td><td align="center">Learn how to install, configure, and authenticate with the library.</td><td></td><td></td><td></td></tr><tr><td><a href="npm-library/usage-examples">usage-examples</a></td><td align="center">Explore practical examples and common use cases for all library features.</td><td></td><td></td><td></td></tr></tbody></table>

## 📋 Prerequisites

Before using the discloud.app library, ensure you have:

✅ **NPM, Yarn, PNPM, or Bun** package manager\
✅ **Discloud API Token** ([Find out how to obtain yours here](https://docs.discloud.com/en/faq/general-questions/how-can-i-get-my-discloud-api-token))

## 💡 Why Use discloud.app?

Whether you're building **automation scripts**, **CI/CD pipelines**, **monitoring dashboards**, or **administrative tools**, the discloud.app library provides:

* **🎯 Simple & Intuitive API** - Clean, promise-based interface that's easy to learn
* **⚡ High Performance** - Optimized for speed with efficient request handling
* **🛡️ Error Handling** - Comprehensive error management and debugging support
* **🔄 Active Development** - Regular updates

***

## 🆘 Need Help?

If you encounter any issues or have questions:

* 📖 Check the [**Usage Examples**](https://docs.discloud.com/en/sdks-and-libraries/npm-library/usage-examples) for common scenarios
* 🐛 Report bugs on [**GitHub Issues**](https://github.com/discloud/discloud.app/issues/new?template=bug.yml)
* 💬 Join our [**Discord Community**](https://discord.discloudbot.com)