Skip to content

zopiolabs/zopio_test_fork

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

77 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

zopio

From idea to enterprise: Full-Stack business framework designed to build scalable apps

npm downloads npm version GitHub license Tech Stack Security Build Release SonarCloud

Overview

zopio is a modern full-stack business framework designed to build scalable business apps with Auto UI and plugin extensibility – built on a developer-first Next.js base. It is designed to be a comprehensive starting point for new apps, providing a solid, opinionated foundation with a minimal amount of configuration.

Getting Started

Clone the repo using:

npx zopio@latest init 

πŸš€ Ready to build something amazing?
πŸ‘‰ Start with the docs

πŸ“ Architecture Overview

The Zopio monorepo is organized into five main workspaces:

  • apps/ – Production apps and user-facing frontends
  • devapps/ – Internal tools for developers
  • packages/ – Shared logic, UI, and system modules
  • registry/ – Plugin & integration catalog with validation
  • websites/ – Public-facing documentation and marketing sites

🧱 Applications (apps/)

Customer-facing and core service apps built on the Zopio framework.

App Description Status
πŸ§‘β€πŸ’Ό app Main SaaS dashboard for customers βœ…
βš™οΈ api Backend API (authentication, business logic) βœ…
πŸ“˜ docs Mintlify-based product documentation βœ…
🌐 web CMS-powered frontend or renderer βœ…
🧩 hub Module marketplace frontend πŸ›£ Roadmap
πŸ›  admin Admin panel for agencies & operators πŸ›£ Roadmap
🧭 onboarding Tenant onboarding wizard with Auto UI πŸ›£ Roadmap
🏒 portal B2B client portal with private content and roles πŸ›£ Roadmap
πŸ“Š status System & API status dashboard (uptime, latency) πŸ›£ Roadmap

πŸ›  Developer Tools (devapps/)

Development and infrastructure support tools, mostly used by internal teams.

Tool Description Status
🧰 cli CLI utility for scaffolding plugins/apps βœ…
πŸ—‚ dbstudio Visual DB explorer (Prisma Studio wrapper) βœ…
βœ‰οΈ emailstudio Resend-compatible email previewer βœ…
🎨 storybook UI component viewer & design system explorer βœ…
πŸ§ͺ uistudio AI-powered Auto UI / page builder πŸ›£ Roadmap
🧩 devpanel System & runtime management panel πŸ›£ Roadmap

πŸ“¦ Shared Packages (packages/)

Modular and reusable building blocks powering all Zopio apps.

Domain Modules (Sample)
πŸ” Auth auth, auth-rbac, auth-hooks, auth-log, auth-abac, auth-runner
🧠 Logic & DX crud, cms, mcp, feature-flags, rate-limit, webhooks
πŸ—ƒ Infra database, data, next-config, security, storage
πŸ”­ Observability analytics, notifications, observability
🎨 UI & Design design-system, email, view, view-builder
πŸ€– Workflow ai, trigger, trigger-rules
🌍 Support internationalization, seo, typescript-config, testing

🧩 Module Registry (registry/)

All modules listed in the hub marketplace are defined here.

Folder Description
πŸ“¦ plugins/ UI plugins and extensions
πŸ”Œ integrations/ External integrations (e.g. Clerk, Stripe, Supabase)
🧱 apps/ Embedded micro frontends (e.g. CMS panel, CRM)
🧰 tools/ CLI helpers (e.g. create-plugin, formatters)
πŸ“‘ schemas/ JSON schema definitions for validation
πŸ§ͺ ci/ Validation scripts and registry tests
🧬 types/ Shared types for metadata (e.g. PluginManifest)
πŸ“š examples/ Usage examples and stubs
πŸ“‚ templates/ Scaffolding templates used by CLI

Each module must include a zopio.module.json manifest file describing its type, entry point, metadata, and optional schema definition.


🌍 Public Websites (websites/)

Folder Description
πŸ“˜ zopio-docs/ Developer and API documentation
✨ zopio-splash/ Public landing / marketing site

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for:

  • Code style and quality standards
  • Pre-commit hooks and CI checks
  • Security analysis with SonarLint
  • PR submission guidelines

❀️ Join Zopio Community

We're building Zopio together with developers like you.

Let's shape the future of business frameworks, together!

DX & Automation Toolkit

🧩 Repository Automation & Contribution Setup

This repo includes automated quality checks and contribution tooling:

Folder Purpose
.github/ GitHub templates, policies, and workflow automation
.husky/ Local Git hooks (e.g. linting, tests before commits)
.vscode/ VS Code workspace config for consistent developer environment (DX/onboarding)
.sonarlint/ SonarLint project-specific rules and configuration
e2e/ End-to-end tests for critical user journeys (e.g. Playwright, Cypress)

These ensure a consistent developer experience and enforce contribution standards across all packages and apps.

πŸ›‘οΈ Code Quality & Security

Zopio uses a comprehensive quality stack to ensure secure, maintainable code:

Tool Purpose Integration
Biome Code formatting & linting Pre-commit, CI
SonarLint Real-time security analysis VSCode
SonarCloud PR quality gates GitHub Actions
TypeScript Type safety Build time

See Code Quality Guide for setup instructions.

About

zopio is a modern full-stack business framework

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 83.1%
  • JavaScript 10.0%
  • MDX 3.4%
  • CSS 2.4%
  • Shell 0.9%
  • HTML 0.1%
  • Handlebars 0.1%