Introduction

OpenSya Core is a convention-driven fullstack runtime designed to power modern recruitment and business platforms through modular architecture, filesystem conventions and generated typings.

Instead of manually wiring every controller, service, model, route or plugin, OpenSya automatically discovers and orchestrates your application based on your project structure.

The goal is simple:

• Reduce repetitive configuration
• Standardize architecture
• Improve scalability
• Generate consistent typings
• Provide a unified fullstack developer experience

The OpenSya Vision

OpenSya is designed to become a complete and extensible infrastructure for recruitment platforms and business ecosystems.

The project aims to provide:

• A modular architecture
• Fully self-hosted deployments
• Shared fullstack conventions
• Open and extensible runtimes
• Strong ownership of data and infrastructure

Unlike traditional SaaS platforms, OpenSya is built around openness, extensibility and long-term scalability.

Architecture

OpenSya Core currently provides two runtimes:

@opensya/core
├── nest/    → Backend runtime powered by NestJS
├── nuxt/    → Frontend runtime powered by Nuxt (coming soon)
└── shared/  → Shared conventions and generated typings

The backend runtime is already available and handles:

• Controllers
• Services
• Database (models, plugins)
• Guards
• Environment variables
• Generated typings
• Runtime orchestration

The frontend runtime will provide a shared convention system for Nuxt applications with integrated typing and module orchestration.

Convention Driven

OpenSya uses your filesystem as the primary source of truth.

server/
├── controllers/
├── services/
├── database/
│   ├── models/
│   └── plugins/
├── guards/
└── locales/

Each directory has a specific responsibility and is automatically discovered by the runtime.

This allows developers to focus on business logic instead of framework wiring.

Why OpenSya?

Philosophy

OpenSya is not a boilerplate or starter kit.

It is a runtime architecture layer designed to standardize how modern recruitment and business applications are structured, discovered and executed.

OpenSya relies on three core ideas:

1. Filesystem conventions
2. Runtime orchestration
3. Generated types

Together, these concepts create a scalable and maintainable developer experience for both backend and frontend applications.