Skip to content

Commit 1f3ff06

Browse files
committed
added read me
1 parent cf97587 commit 1f3ff06

File tree

1 file changed

+75
-0
lines changed

1 file changed

+75
-0
lines changed

README.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
<h1>Cloudways JS Client</h1>
2+
3+
<p>
4+
<a href="https://badge.fury.io/js/cloudways-js-client"><img src="https://badge.fury.io/js/cloudways-js-client.svg" alt="npm version"></a>
5+
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
6+
<span><img src="https://img.shields.io/badge/TypeScript-Ready-blue" alt="TypeScript Ready"></span>
7+
</p>
8+
9+
<h2>Description</h2>
10+
11+
<p>
12+
Cloudways JS Client is a <strong>TypeScript-based</strong> client library that allows you to power your applications with the Cloudways API.
13+
It provides a convenient and strongly-typed way to interact with the Cloudways API, enabling you to manage servers, perform automation,
14+
and integrate Cloudways functionality into your web applications.
15+
</p>
16+
17+
<h2>🚧 Under Development 🚧</h2>
18+
19+
<p>
20+
Please note that this library is still under development. Although it's functional and can be used, some features might be incomplete or subject to changes.
21+
</p>
22+
23+
<h2>Features</h2>
24+
25+
<ul>
26+
<li>Easy-to-use client library for the Cloudways API.</li>
27+
<li>Simplifies server management and web app integration.</li>
28+
<li><strong>Built with TypeScript</strong> for improved type safety and development experience.</li>
29+
<li>Comprehensive documentation and code examples, including JSDoc comments.</li>
30+
</ul>
31+
32+
<h2>Installation</h2>
33+
34+
<p>You can install the package via npm:</p>
35+
36+
<pre><code>npm install cloudways-js-client
37+
</code></pre>
38+
39+
<h2>Usage</h2>
40+
41+
<p>
42+
To get you started, here's an example that demonstrates how to get the status of a background operation using the "Get Operation Status" function:
43+
</p>
44+
45+
<pre><code>import { getOperationStatus, GetOperationStatusRequest } from 'cloudways-js-client';
46+
47+
const payload: GetOperationStatusRequest = {
48+
id: 123456 // Replace with the operation ID you have
49+
};
50+
51+
async function fetchOperationStatus() {
52+
try {
53+
const response = await getOperationStatus(payload);
54+
console.log("Operation Status:", response.operation);
55+
} catch (error) {
56+
console.error("Error fetching operation status:", error);
57+
}
58+
}
59+
60+
fetchOperationStatus();
61+
</code></pre>
62+
63+
<p>For detailed usage examples and API documentation, please refer to the <a href="https://developers.cloudways.com/docs/">documentation</a>.</p>
64+
65+
<h2>Contributing</h2>
66+
67+
<p>Contributions are welcome! Please follow the <a href="https://github.com/code-gio/cloudways-js-client/blob/main/CONTRIBUTING.md">contribution guidelines</a> when making contributions to this project.</p>
68+
69+
<h2>Issues</h2>
70+
71+
<p>If you find any issues or have any feature requests, please open an <a href="https://github.com/code-gio/cloudways-js-client/issues">issue</a> on GitHub.</p>
72+
73+
<h2>License</h2>
74+
75+
<p>This project is open source and available under the <a href="https://opensource.org/licenses/MIT">MIT License</a>.</p>

0 commit comments

Comments
 (0)