IOTA SDK

NPM: @iota-uz/sdk

This repo now ships a unified public NPM package for UI + Tailwind sharing:

• Applet Core (React utilities): @iota-uz/sdk
• BIChat UI (React): @iota-uz/sdk/bichat
• Tailwind v4 inputs + config helper: @iota-uz/sdk/tailwind/*
• Bundled assets (fonts): serve node_modules/@iota-uz/sdk/assets at /assets

Tailwind (consumer compiles):

pnpm add -D tailwindcss @tailwindcss/cli
pnpm add @iota-uz/sdk

// tailwind.config.cjs
const createIotaTailwindConfig = require('@iota-uz/sdk/tailwind/create-config')

module.exports = createIotaTailwindConfig({
  content: ['./src/**/*.{ts,tsx,js,jsx,html}'],
  extend: {},
})

# Create an input CSS file in your project (example: ./src/tailwind.css):
#   @config "../tailwind.config.cjs";
#   @import "@iota-uz/sdk/tailwind/main.css";
tailwindcss --input ./src/tailwind.css --output ./public/assets/main.css --minify

🔗 Links

• Documentation: Official documentation and guides
• Discord Community: Join our community for support and Q&A
• Contribution Guide: Learn how to contribute to the project
• Setup Demo: Learn how to setup IOTA-SDK
• Demo stand: Explore the SDK UI
• Docker hub - Official Docker images
• Roadmap (Coming soon...): Explore our upcoming features and milestones
• Figma Designs (Coming soon...): Access and contribute to our open-source designs

🛠 Built With

• Go: A statically typed, compiled programming language designed for high performance.
• htmx: Enables modern interactivity with minimal JavaScript.
• Alpine.js: A lightweight JavaScript framework for reactive components.
• Templ: A powerful templating system for building server-rendered web applications.

---

A Modular and Configurable ERP Solution

IOTA SDK is an open-source, modular, and feature-complete ERP system designed to adapt to multiple economic sectors, including finance, manufacturing, and warehouse management. Inspired by leading platforms like Odoo, IOTA SDK provides an intuitive framework to accelerate enterprise operations and unlock efficiency with powerful tools and integrations.

---

🚀 Key Features

• Configurable Architecture: Fully modular components to customize workflows.
• Industry-Specific Modules: Finance, manufacturing, warehouse management, and more.
• GraphQL API: Simplifies querying and data management.
• Open Source: Fully extensible and transparent.

---

📅 Roadmap

We have an ambitious roadmap to enhance IOTA SDK's capabilities and provide a robust framework for ERP needs across various industries. Here's what's in the pipeline:

Core Modules

• Finance & Accounting: Develop comprehensive tools for managing financial operations, including general ledger, accounts payable/receivable, and payroll.

Work In Progress

• CRM: Building a customer relationship management module to streamline client interactions and sales processes.
• BI‑Chat: Introducing a business intelligence chatbot for real-time data insights and reporting.

Upcoming Features

• HRM: Integrate a human resources management module for employee onboarding, payroll, and benefits.
• Password Vault: Securely store and manage sensitive credentials within the platform.
• DSL: Integrate V8/Python for scripting and customizations.
• Logging: Implement a logging system for tracking user actions and system events.
• Invoice and Document Generation: Leverage GOBL for generating and managing invoices and other essential business documents.
• Open Source Designs and Documentation: Share Figma designs and other internal documentation to help the community understand the vision and contribute more effectively.

---

🛠️ Developer Tools

Automated Tool Installation

Install all required development tools with a single command:

just install-tools

This installs the following tools with correct versions:

• templ v0.3.857 - Template engine
• air v1.61.5 - Hot reload for Go applications
• goimports - Go imports organizer
• golangci-lint v1.64.8 - Go linter
• TailwindCSS v4 (via pnpm at repo root)
• cloudflared - Cloudflare tunnel client

The script automatically detects your OS (macOS/Linux) and architecture, downloads binaries, creates symlinks, and configures your PATH.

Prerequisites: Go and Homebrew (macOS only) must be installed first.

Node/pnpm: The repo pins pnpm@9.15.0 via the packageManager field in package.json. Ensure Corepack is enabled (corepack enable) in CI and contributor environments so the correct pnpm version is used; otherwise npm or yarn may run without warning.

CI Security Scanning (gosec)

The CI pipeline runs gosec on pull requests to main and on direct pushes to main. The scan is focused on production server entrypoints (cmd/server and cmd/superadmin). Generated files are excluded. The scan is configured to fail the build when high-severity findings are detected.

Run the same check locally:

go install github.com/securego/gosec/v2/cmd/gosec@v2.22.2
just gosec

For full setup instructions, see the Installation Guide.

🔐 Super Admin

IOTA SDK includes a separate Super Admin server for managing tenants and platform-wide operations. This deployment is isolated from the main application and requires super admin authentication for all routes.

Key Features:

• Separate deployment context (uses same environment variables)
• Only core + superadmin modules loaded (lightweight)
• Global authentication middleware enforcing super admin access
• Tenant management and platform analytics

Quick Start:

# Build Super Admin server
docker build -f Dockerfile.superadmin -t iota-sdk-superadmin .

# Run Super Admin server (uses same env vars as main app)
docker run -p 3000:3000 \
  -e DATABASE_URL=postgres://... \
  -e PORT=3000 \
  iota-sdk-superadmin

For detailed documentation, deployment guides, and authentication flow, see Super Admin Documentation.

---

📄 Licence

Apache 2.0

Updated at Dec 31, 2025

🌟 Join Us

We welcome contributions to improve and expand IOTA SDK! Check out our contributing guide to get started.