PHPackages                             eru123/opensys - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. eru123/opensys

ActiveProject

eru123/opensys
==============

00TypeScript

Since Feb 24Pushed 3mo agoCompare

[ Source](https://github.com/eru123/opensys)[ Packagist](https://packagist.org/packages/eru123/opensys)[ RSS](/packages/eru123-opensys/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (3)Used By (0)

AI Base Starter Template
========================

[](#ai-base-starter-template)

AI Base is a production-minded **starter template** for building internal platforms and SaaS control panels with a PHP 8.2+ API and a React + Vite + TypeScript frontend.

It gives you a strong foundation out of the box:

- Authentication + session management (login, refresh, logout, profile).
- Admin onboarding + invitation flows.
- System settings modules (security, SMTP, company).
- Email template management and send tooling.
- Audit logging and error logging primitives.
- A reusable Tailwind + Radix component system.

Why this template exists
------------------------

[](#why-this-template-exists)

Most teams lose time rebuilding the same platform concerns (auth, settings, logs, admin UX) before shipping domain features. AI Base is designed to remove that friction while keeping architecture clean, explicit, and extensible.

Tech Stack
----------

[](#tech-stack)

- **Frontend**: React 18, TypeScript, Vite, Tailwind CSS, Radix UI, React Query, React Hook Form + Zod
- **Backend**: PHP 8.2+, PSR-4 service/controller/model structure
- **Database**: MySQL + Phinx migrations
- **Tooling**: ESLint, TypeScript checks, Composer, pnpm

Starter Quick Start
-------------------

[](#starter-quick-start)

### 1) Create project

[](#1-create-project)

```
composer create-project eru123/opensys my-app -s dev
cd my-app
```

This automatically installs Composer and pnpm dependencies, and creates your `.env` file.

> **Already cloned?** Just run `composer install` — it also triggers `pnpm install` automatically.

### 2) Configure environment

[](#2-configure-environment)

Update `.env` as needed (database + app URLs + optional branding values).

### 3) Create database and run migrations

[](#3-create-database-and-run-migrations)

```
mysql -u root -p -e "CREATE DATABASE opensys;"
pnpm db:migrate
```

### 4) Start development server

[](#4-start-development-server)

```
pnpm dev
```

`pnpm dev` starts both the Vite frontend and the PHP backend server.

### 5) Open the app

[](#5-open-the-app)

- Frontend: `http://localhost:5173`
- API base:

Validation Commands
-------------------

[](#validation-commands)

Run these before opening a PR:

```
pnpm lint
pnpm type-check
pnpm build
```

If backend logic changes, also run relevant PHP checks (for example, migration command sanity checks and endpoint smoke tests).

Project Structure
-----------------

[](#project-structure)

```
src/                # React pages, layouts, hooks, shared UI components
api/Controllers/    # HTTP endpoint orchestration
api/Services/       # Business logic and cross-cutting concerns
api/Models/         # Data persistence and query logic
db/migrations/      # Database schema history
docs/               # Setup, architecture, deployment, API docs

```

Template Customization Checklist
--------------------------------

[](#template-customization-checklist)

When adapting this starter for your own product, do at least the following:

1. Update branding vars in `.env` (`VITE_APP_NAME`, company labels, etc.).
2. Review user roles/permissions in backend services and UI route gating.
3. Replace sample email template content with your product messaging.
4. Configure SMTP settings via the System Settings admin panel.
5. Add domain modules in `src/pages` + `api/Controllers|Services|Models` using current architecture boundaries.

Documentation Index
-------------------

[](#documentation-index)

- [Getting Started](docs/getting-started.md)
- [API Reference](docs/api-reference.md)
- [Deployment Guide](docs/deployment.md)
- [Contributing Guide](docs/contributing.md)
- [Caching Notes](docs/caching.md)
- [Email Service](docs/email-service.md)
- [Implementation Scope](docs/implementation-progress.md)

License
-------

[](#license)

Proprietary (see `composer.json`).

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance52

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/05166f465b8d50e88f58c04319272489cffe23c3b85360244973f973e18c1c0f?d=identicon)[eru123](/maintainers/eru123)

---

Top Contributors

[![eru123](https://avatars.githubusercontent.com/u/39824083?v=4)](https://github.com/eru123 "eru123 (40 commits)")

### Embed Badge

![Health badge](/badges/eru123-opensys/health.svg)

```
[![Health](https://phpackages.com/badges/eru123-opensys/health.svg)](https://phpackages.com/packages/eru123-opensys)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)