{"id":51018032,"url":"https://github.com/natuleadan/agents-pro","last_synced_at":"2026-06-21T13:30:47.863Z","repository":{"id":343311931,"uuid":"1111569726","full_name":"natuleadan/agents-pro","owner":"natuleadan","description":"Natuleadan's AIO for AI agents fullstack NextJS Supabase Uptash (and more) with dynamic SSR pages and RBAC dashboard for administration with cooked APIs for use and connect agents with tooling","archived":false,"fork":false,"pushed_at":"2026-05-13T05:02:29.000Z","size":82685,"stargazers_count":5,"open_issues_count":6,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-13T07:07:40.950Z","etag":null,"topics":["agent-framework","agentic-workflow","agents","ai","development","iceberg","natuleadan","pwa","self-hosted","sql","typescript","web","workflow"],"latest_commit_sha":null,"homepage":"https://natuleadan.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/natuleadan.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":"COPYRIGHT.md","agents":null,"dco":null,"cla":null}},"created_at":"2025-12-07T07:51:26.000Z","updated_at":"2026-05-09T23:07:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/natuleadan/agents-pro","commit_stats":null,"previous_names":["natuleadan/nla-fullstack","natuleadan/agents-pro"],"tags_count":73,"template":false,"template_full_name":null,"purl":"pkg:github/natuleadan/agents-pro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natuleadan%2Fagents-pro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natuleadan%2Fagents-pro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natuleadan%2Fagents-pro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natuleadan%2Fagents-pro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/natuleadan","download_url":"https://codeload.github.com/natuleadan/agents-pro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natuleadan%2Fagents-pro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34610832,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-framework","agentic-workflow","agents","ai","development","iceberg","natuleadan","pwa","self-hosted","sql","typescript","web","workflow"],"created_at":"2026-06-21T13:30:46.098Z","updated_at":"2026-06-21T13:30:47.858Z","avatar_url":"https://github.com/natuleadan.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"public/images/logo.svg\" alt=\"NLA Fullstack\" width=\"120\" height=\"120\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eNLA Fullstack\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\u003cstrong\u003eEnterprise Operations Platform\u003c/strong\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/natuleadan/nla-fullstack/actions/workflows/ci.yml?branch=main\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/natuleadan/nla-fullstack/ci.yml?branch=main\u0026style=for-the-badge\" alt=\"CI status\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/natuleadan/nla-fullstack/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/natuleadan/nla-fullstack?include_prereleases\u0026style=for-the-badge\" alt=\"GitHub release\" /\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-Dual-blue.svg?style=for-the-badge\" alt=\"Dual License\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Status-In%20Development-orange?style=for-the-badge\" alt=\"In Development\" /\u003e\n\u003c/p\u003e\n\n\u003e ⚠️ **Active Development** — This platform is under active construction. APIs, module interfaces, and features may change without prior notice. For production use, rely only on tagged releases (`vX.Y.Z`).\n\n## 1. What is NLA Fullstack?\n\nNLA Fullstack is an Enterprise Operations Platform currently in development that enables asynchronous business automation through conversational AI. It combines an AI Agent with comprehensive content and commerce management, allowing enterprises to self-manage operations, schedule tasks, and automate workflows within a unified codebase.\n\nThe platform enables AI-driven interactions with structured business data across multiple domains: products, courses, orders, articles, accounting, and more. All operations follow Zero Trust security principles with Row Level Security (RLS) enforcement. Built on Next.js 16, TypeScript, and Supabase.\n\n## 2. Core Capabilities\n\n### AI Agent\n\nThe Agent provides natural language interactions with streaming responses and can execute actions like searching products, creating orders, and fetching data. It has contextual awareness of regional settings (language, country, currency), user roles, and visibility rules. Tools respect RBAC and only expose data the user is authorized to access.\n\n### Content \u0026 Commerce Management\n\nModules include: Products (catalog with variants, pricing, inventory, ratings), Courses (learning platform with lessons, quizzes, progress), Orders (lifecycle, tracking, payments), Content (articles, news, pages with multi-language support), Users (authentication, profiles, role-based permissions), Accounting (invoices, financial tracking), Contacts (CRM functionality), and Services (professional services management).\n\n### Technical Features\n\nSecurity: Zero Trust architecture, RLS policies, dual auth (JWT + API Keys). Performance: Next.js 16 caching with strategic revalidation, Supabase Realtime. Scalability: Modular service architecture, separation of concerns. Internationalization: Multi-language (ES, EN, AR) with RTL support. Analytics: Event tracking, audit logging. File Management: Secure storage with signed URLs, access control.\n\n## 3. Technology Stack\n\nBackend powered by Next.js 16 with TypeScript 5.7+ strict mode. Database: Supabase PostgreSQL with Row Level Security. AI integration via Vercel AI SDK with GPT-5 models. Frontend built with Tailwind CSS and Base UI components. Testing with Vitest. Infrastructure on Vercel with multi-platform Docker builds (amd64, arm64).\n\n## 4. Project Status\n\nInfrastructure: PostgreSQL schema with RLS (15+ tables, 20+ policies), dual auth (JWT + API Keys), context-aware caching, secure file storage (15 buckets), audit logging, rate limiting.\n\nModules: 4 in advanced stages (Products, Courses, Contents, Orders), 11 in progress (Banking, Contacts, Projects, Services, Certificates, Settings, Dashboard, Agents, Security, Devices, and others).\n\nOur Changelog contains a comprehensive timeline of all versions, featuring detailed changelogs, feature announcements, deprecation notices, and migration guides for each release cycle. This documentation helps users understand what has changed, what is new, and how to properly upgrade between versions. [Changelog](CHANGELOG.md)\n\n## 5. Getting Started\n\nPrerequisites: Node.js 24.0.0+ LTS, pnpm, Supabase account, and Vercel account. Clone the repository, install dependencies with `pnpm install`, configure `.env` with credentials, then run `pnpm dev` for local development.\n\nOur Contribution Guidelines document provides comprehensive guidance on how to participate in the project, including instructions for reporting bugs, suggesting new features, submitting pull requests, coding standards, commit conventions, and the pull request review process. This guide ensures consistency and quality across all contributions. [Contribution Guidelines](CONTRIBUTING.md)\n\n## 6. Architecture \u0026 Security\n\nThe Technical Documentation index contains the full architecture reference: stack details, module status, agent tools registry, media operators, OG image rules, commit conventions, and per-module documentation stubs ready to be filled as modules complete. [Technical Documentation](documentation/01-overview/docs.index.md)\n\nOur Security Policy document outlines our Zero Trust architecture implementation, detailed RLS policy explanations, role-based access control mechanisms, caching strategies for performance optimization, vulnerability disclosure procedures, and security best practices for deployment and operation. This document also contains contact information for reporting security issues responsibly. [Security Policy](SECURITY.md)\n\n## 7. Licensing\n\nNLA Fullstack uses a Dual License Model. Option 1: Natuleadan Free License for small organizations (revenue less than $100k per year) is free with annual attestation. Option 2: Natuleadan Business License (revenue greater than or equal to $100k per year) has custom pricing.\n\nOur License Terms and Conditions document provides the complete legal framework including all license conditions, ethical restrictions that must be followed, business licensing terms and pricing structure, developer protections and warranties, limitation of liability, and governing law provisions. This document is the authoritative source for understanding your rights and obligations when using NLA Fullstack. [License Terms and Conditions](LICENSE_TERMS.md)\n\nThe Natuleadan Free License document grants rights to organizations meeting the revenue threshold (less than $100k/year), subject to annual attestation and compliance obligations. [Natuleadan Free License](LICENSE.md)\n\nThe Natuleadan Business License document provides specific licensing arrangements for organizations with annual gross revenue equal to or exceeding $100k, including custom pricing, support SLAs, and access to confidential modules (.ee). [Natuleadan Business License](LICENSE_EE.md)\n\nThe License Forms document contains all necessary forms for license compliance, including the annual attestation form required for Natuleadan Free License users to certify their eligibility, application forms for business licensing, and other compliance documentation needed to formally document your license status. [Annual License Form](LICENSE_FORMS.md)\n\nImportant: The Natuleadan Free License does not include technical support, advisory services, or warranties. The Natuleadan Business License may optionally include these services (Warranty, SLA, Accelerated Security Updates, Specialized Advisory) via separately negotiated agreements — they are not included by default. See [License Terms and Conditions](LICENSE_TERMS.md) Section 8 for details.\n\nOur Code of Conduct document establishes ethical restrictions and prohibited uses, defining the behavioral expectations for all participants and outlining what activities are not permitted under the project licenses. Combined with the License Terms, these documents create a complete framework for acceptable use. [Code of Conduct](CODE_OF_CONDUCT.md)\n\n## 8. Ownership \u0026 Copyright\n\nOur Copyright document provides complete details on ownership of the project, intellectual property rights, contributor rights and how they are managed, the licensing chain explaining how different components are licensed, attribution requirements, and the overall legal structure of the project's ownership. [Copyright](COPYRIGHT.md)\n\n## 9. Contributing\n\nNLA Fullstack is built by volunteers. All contributions are unpaid and voluntary.\n\nOur Contribution Guidelines document provides detailed instructions on how to report bugs effectively, suggest new features, submit code through pull requests, and follow our coding standards and commit message conventions. This ensures all contributions meet our quality requirements. [Contribution Guidelines](CONTRIBUTING.md)\n\nThe Code of Conduct document establishes the community values and conduct expectations, defining the respectful and professional environment we maintain. It outlines how members should interact, resolve disagreements, and contribute positively to the community. [Code of Conduct](CODE_OF_CONDUCT.md)\n\nOur Contributors document explains how contributors are recognized, the acknowledgment process, and how the community celebrates individual contributions to the project. [Contributors](CONTRIBUTORS.md)\n\nThe Contributor License Agreement document is a legal requirement before contributing. This agreement transfers all intellectual property rights in your contributions to the code owner, ensuring clear ownership and preventing future disputes. You must read and accept this agreement before your first contribution is accepted. [Contributor License Agreement](CONTRIBUTOR_CLA.md)\n\nKey guidelines: Reference existing patterns for consistency. Target greater than 80% test coverage as a quality requirement. Pass lint and build as non-negotiable checks. Maintain separation between lib/ (data) and design/ (UI). Document new patterns to help future developers. Respect security rules including RLS, visibility, and authentication.\n\n## 10. Development Workflow\n\nFollow a modular approach: plan changes, update database schema, define types with Zod, implement repository queries with RLS, add service logic with caching, expose APIs as needed, integrate agent tools, build UI components, write tests (greater than 80% coverage), and pass quality checks.\n\nCode organization: lib/ contains business logic (data source of truth), design/ contains UI components, feature orchestration, data assemblers, and metadata. Never access Supabase directly outside repositories; always pass userRole to services.\n\n## 11. Support\n\nFor common issues, consult the troubleshooting documentation or open an issue on GitHub.\n\nOur Security Policy document contains specific procedures for reporting security vulnerabilities, responsible disclosure guidelines, and contact information for security-related issues. If you discover a security issue, this document explains how to report it properly. [Security Policy](SECURITY.md)\n\n## 12. License \u0026 Legal\n\nOur License Terms and Conditions document is the authoritative source for all legal aspects of using NLA Fullstack, containing complete license terms, conditions, ethical restrictions, commercial licensing details, developer protections, warranty disclaimers, limitation of liability, and governing law provisions. This document should be your primary reference for any legal question about the project. [License Terms and Conditions](LICENSE_TERMS.md)\n\nThe Copyright document provides the ownership and responsibility structure, explaining who owns the project, how intellectual property is managed, contributor rights, and the overall legal framework supporting the project. [Copyright](COPYRIGHT.md)\n\nThe License Terms document also contains governing law and venue provisions, establishing which jurisdiction's laws apply and where legal disputes should be resolved. [License Terms and Conditions](LICENSE_TERMS.md)\n\nThe Code of Conduct and License Terms documents together define all ethical restrictions and prohibited uses, establishing what activities are not permitted and the consequences for violations. These documents ensure the project is used responsibly and ethically. [Code of Conduct](CODE_OF_CONDUCT.md) [License Terms and Conditions](LICENSE_TERMS.md)\n\n---\n\n## Community\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and how to submit PRs.\nAI/vibe-coded PRs welcome! 🤖\n\nThanks to all contributors:\n\n\u003cp align=\"left\"\u003e\n  \u003ca href=\"https://github.com/natuleadan\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/210283438?v=4\u0026s=48\" width=\"48\" height=\"48\" alt=\"natuleadan\" title=\"natuleadan\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/leojara95\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/268038834?v=4\u0026s=48\" width=\"48\" height=\"48\" alt=\"leojara95\" title=\"leojara95\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Star History\n\n\u003ca href=\"https://www.star-history.com/?repos=natuleadan%2Fnla-fullstack\u0026type=date\u0026legend=top-left\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/image?repos=natuleadan/nla-fullstack\u0026type=date\u0026theme=dark\u0026legend=top-left\" /\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/image?repos=natuleadan/nla-fullstack\u0026type=date\u0026theme=light\u0026legend=top-left\" /\u003e\n    \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/image?repos=natuleadan/nla-fullstack\u0026type=date\u0026legend=top-left\" /\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatuleadan%2Fagents-pro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnatuleadan%2Fagents-pro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatuleadan%2Fagents-pro/lists"}