Skip to content

Introduction to the SDK

Welcome to the Qelos SDK documentation. This section provides an overview of the SDK, including its core features, installation, and basic usage. Whether you are a developer or an administrator, this guide will help you get started with the SDK.

Key Features

Authentication

Secure user authentication with OAuth and session-based options. Includes automatic token refresh and session management.

Token Management

Automatic token refresh functionality to maintain user sessions without interruption.

Blueprints

Create and manage data models with powerful blueprint operations for your application.

Configurations

Manage application configurations with easy-to-use APIs for retrieval and updates.

Layouts

Create and customize UI layouts for your Qelos-powered applications.

Plugins

Extend functionality with plugins to connect to other micro-SaaS platforms.

User Management

Comprehensive APIs for managing users, permissions, and roles.

Workspace Management

Multi-tenant support with workspace management capabilities.

Error Handling

Robust error handling patterns and best practices for reliable applications.

Getting Started

Installation

To install the Qelos SDK, use your preferred package manager:

bash
npm install @qelos/sdk
# or
yarn add @qelos/sdk
# or
pnpm add @qelos/sdk

Basic Setup

typescript
import { QelosSDK } from '@qelos/sdk';

// Initialize the SDK
const sdk = new QelosSDK({
  appUrl: 'https://your-qelos-app.com',
  forceRefresh: true, // Enable automatic token refresh
});

// Authenticate the user
await sdk.authentication.oAuthSignin({
  username: 'user@example.com',
  password: 'password'
});

// Now you can use the SDK to interact with Qelos
const workspaces = await sdk.workspaces.getList();
const userProfile = await sdk.authentication.getLoggedInUser();

Developer Resources

Authentication Tutorial

Learn how to implement a complete authentication flow in your application.

TypeScript Types

Comprehensive guide to TypeScript types in the SDK for better development experience.

Troubleshooting

Solutions for common issues and debugging techniques.

About Qelos

Qelos is a SaaS platform developed by Velocitech LTD that enables you to create your own SaaS applications with multi-tenant capabilities. The platform provides a comprehensive set of tools and APIs to build, deploy, and manage your applications efficiently.

Released under the Apache License 2.0.