iota-sdk
# 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): ```bash pnpm add -D tailwindcss @tailwindcss/cli pnpm add @iota-uz/sdk ``` ```js // tailwind.config.cjs const createIotaTailwindConfig = require('@iota-uz/sdk/tailwind/create-config') module.exports = createIotaTailwindConfig({ content: ['./src/**/*.{ts,tsx,js,jsx,html}'], extend: {}, }) ``` ```bash # 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](https://iota-uz.github.io/iota-sdk/): Official documentation and guides - [Discord Community](https://discord.gg/zKeTEZAQqF): Join our community for support and Q&A - [Contribution Guide](docs/CONTRIBUTING.MD): Learn how to contribute to the project - [Setup Demo](https://github.com/iota-uz/sdk-demo): Learn how to setup IOTA-SDK - [Demo stand](https://demo.iotaerp.com): Explore the SDK UI - [Docker hub](https://hub.docker.com/r/iotauz/sdk) - Official Docker images - [Roadmap (Coming soon...)](docs/): Explore our upcoming features and milestones - [Figma Designs (Coming soon...)](https://www.figma.com/): Access and contribute to our open-source designs ## 🛠 Built With - [Go](https://go.dev): A statically typed, compiled programming language designed for high performance. - [htmx](https://htmx.org): Enables modern interactivity with minimal JavaScript. - [Alpine.js](https://alpinejs.dev): A lightweight JavaScript framework for reactive components. - [Templ](https://templ.sh): 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](https://github.com/invopop/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: ```bash 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 `[email protected]` via the `packageManager` field in `package.json`. Ensure [Corepack](https://nodejs.org/api/corepack.html) 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`](https://github.com/securego/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: ```bash go install github.com/securego/gosec/v2/cmd/[email protected] just gosec ``` For full setup instructions, see the [Installation Guide](https://iota-uz.github.io/iota-sdk/getting-started/installation.html). ## 🔐 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:** ```bash # 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](https://iota-uz.github.io/iota-sdk/superadmin/). --- ## 📄 Licence Apache 2.0 Updated at Dec 31, 2025 ## 🌟 Join Us <img width="250" style="display: block" src="https://cdn.prod.website-files.com/660549b5ac888804e6582845/6606afddd43da2d659209149_logo.svg"> We welcome contributions to improve and expand IOTA SDK! Check out our [contributing guide](docs/CONTRIBUTING.MD) to get started.