PHPackages                             hytek/framex - 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. [Framework](/categories/framework)
4. /
5. hytek/framex

ActiveProject[Framework](/categories/framework)

hytek/framex
============

FrameX is a production-ready Laravel starter kit featuring Inertia, TypeScript, authentication, billing, real-time features, testing, and modern developer tooling.

v1.1.0(3w ago)191MITTypeScriptPHP ^8.3CI failing

Since Sep 7Pushed 3w ago1 watchersCompare

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

READMEChangelog (2)Dependencies (33)Versions (6)Used By (0)

FrameX - Laravel 13 Team Management Application
===============================================

[](#framex---laravel-13-team-management-application)

A modern full-stack web application built with **Laravel 13**, **React**, **TypeScript**, and **Inertia.js**. FrameX provides comprehensive team management, user authentication, billing integration, and real-time collaboration features.

Features
--------

[](#features)

### Core Features

[](#core-features)

- **User Authentication** - Secure authentication with two-factor authentication (2FA) support
- **Team Management** - Create, manage, and collaborate within teams
- **Role-Based Access Control** - Fine-grained permission system for team members
- **User Profiles** - Customizable user profiles with team switching
- **Activity Logging** - Track and audit team activities
- **Notification Preferences** - Configurable notification settings per user

### Advanced Features

[](#advanced-features)

- **Payment Integration** - Stripe integration via Laravel Cashier for subscription management
- **API Authentication** - Sanctum-based API tokens for secure third-party integrations
- **Real-Time Features** - WebSocket support via Laravel Reverb for live updates
- **File Management** - Team file storage and management
- **Team Invitations** - Invite and manage team members with email invitations
- **Two-Factor Authentication** - Enhanced security with 2FA support

🚀 Tech Stack
------------

[](#-tech-stack)

### Backend

[](#backend)

- **PHP** 8.3+
- **Laravel Framework** 13.7 - Modern PHP web framework
- **Laravel Fortify** - Authentication backend
- **Laravel Sanctum** - API token authentication
- **Laravel Cashier** - Stripe payment processing
- **Laravel Reverb** - Real-time WebSocket server
- **Pest** - Modern PHP testing framework

### Frontend

[](#frontend)

- **React** - Modern UI library
- **Inertia.js** - Server-driven SPA framework
- **TypeScript** - Type-safe JavaScript
- **Tailwind CSS** - Utility-first CSS framework
- **Radix UI** - Headless UI components
- **Vite** - Fast build tool

### Database & Tools

[](#database--tools)

- **Laravel Migrations** - Database schema management
- **Faker** - Seed data generation
- **Pest** - Testing framework
- **Laravel Pint** - Code style formatter
- **ESLint** - JavaScript linter
- **Prettier** - Code formatter

📋 Project Structure
-------------------

[](#-project-structure)

```
├── app/
│   ├── Actions/          # Action classes (Fortify, Teams)
│   ├── Concerns/         # Reusable traits for models
│   ├── Enums/            # Enumeration classes
│   ├── Events/           # Event classes
│   ├── Http/             # Controllers, Middleware, Requests, Responses
│   ├── Models/           # Eloquent models
│   ├── Notifications/    # Notification classes
│   ├── Policies/         # Authorization policies
│   ├── Providers/        # Service providers
│   ├── Rules/            # Custom validation rules
│   └── Support/          # Helper classes
├── bootstrap/            # Application bootstrapping
├── config/               # Configuration files
├── database/
│   ├── factories/        # Model factories
│   ├── migrations/       # Database migrations
│   └── seeders/          # Database seeders
├── public/               # Public assets
├── resources/
│   ├── css/              # Stylesheets
│   ├── js/               # React components and pages
│   └── views/            # Blade view templates
├── routes/               # Application routes
├── storage/              # Application storage
├── tests/                # Test files
│   ├── Feature/          # Feature tests
│   └── Unit/             # Unit tests
└── vendor/               # Composer dependencies

```

### Key Models

[](#key-models)

- **User** - User accounts with team support, 2FA, and billing
- **Team** - Team records with permissions and roles
- **Membership** - Join table linking users to teams
- **TeamInvitation** - Pending team invitations
- **ActivityLog** - Team activity history
- **TeamFile** - Team file storage
- **NotificationPreference** - User notification settings

🔐 Authorization & Permissions
---------------------------------

[](#-authorization--permissions)

### Team Roles

[](#team-roles)

- **Owner** - Full control over team
- **Admin** - Administrative access
- **Member** - Basic member access
- Custom roles with granular permissions

### Policies

[](#policies)

- **TeamPolicy** - Controls team access and management
- Authorization middleware for protected routes

🛠️ Installation
---------------

[](#️-installation)

### Prerequisites

[](#prerequisites)

- PHP 8.3 or higher
- Composer
- Node.js 18+ and npm/pnpm
- Git

### Setup Instructions

[](#setup-instructions)

**Creating an Application Using a Starter Kit**

```
laravel new my-app --using=hytek/framex
```

### Docker Setup (Optional)

[](#docker-setup-optional)

```
./vendor/bin/sail up -d
sail composer install
sail npm install
sail artisan migrate
sail npm run dev
```

📦 Available Commands
--------------------

[](#-available-commands)

### Frontend Development

[](#frontend-development)

```
pnpm run dev          # Start Vite dev server with hot reload
pnpm run build        # Build production assets
pnpm run build:ssr    # Build with SSR support
pnpm run lint         # Run ESLint with auto-fix
pnpm run lint:check   # Check code style without fixing
pnpm run format       # Format code with Prettier
pnpm run format:check # Check formatting without fixing
pnpm run types:check  # Check TypeScript types
```

### Backend Development

[](#backend-development)

```
php artisan migrate              # Run database migrations
php artisan db:seed              # Seed the database
php artisan tinker               # Interactive shell
php artisan serve                # Start development server
php artisan reverb:start          # Start WebSocket server
php artisan horizon              # Start queue worker
php artisan sail up -d           # Start Docker containers
```

### Testing

[](#testing)

```
./vendor/bin/pest                # Run all tests
./vendor/bin/pest --filter=TestName  # Run specific test
./vendor/bin/pest --coverage     # Generate coverage report
php artisan test                 # Alternative test runner
```

### Code Quality

[](#code-quality)

```
composer pint                    # Fix PHP code style
pnpm run lint                    # Fix JavaScript/TypeScript style
pnpm run format                  # Format code with Prettier
```

🔌 Configuration
---------------

[](#-configuration)

### Key Configuration Files

[](#key-configuration-files)

- **config/app.php** - Application settings
- **config/auth.php** - Authentication configuration
- **config/database.php** - Database configuration
- **config/fortify.php** - Fortify authentication settings
- **config/inertia.php** - Inertia.js settings
- **config/cashier.php** - Stripe payment configuration
- **config/reverb.php** - WebSocket configuration

### Environment Variables

[](#environment-variables)

```
APP_NAME=FrameX
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost

DB_CONNECTION=sqlite
# or
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=framex
DB_USERNAME=root
DB_PASSWORD=

STRIPE_PUBLIC_KEY=your_stripe_public_key
STRIPE_SECRET_KEY=your_stripe_secret_key

SANCTUM_STATEFUL_DOMAINS=localhost:3000
```

🧪 Testing
---------

[](#-testing)

### Running Tests

[](#running-tests)

```
# All tests
./vendor/bin/pest

# Specific test file
./vendor/bin/pest tests/Feature/AuthenticationTest.php

# With coverage report
./vendor/bin/pest --coverage
```

### Test Structure

[](#test-structure)

- **Feature Tests** - Integration tests for API endpoints and features
- **Unit Tests** - Individual component and method tests

🔄 API Endpoints
---------------

[](#-api-endpoints)

### Authentication

[](#authentication)

- `POST /login` - User login
- `POST /register` - User registration
- `POST /logout` - User logout
- `POST /two-factor-challenge` - 2FA verification

### Teams

[](#teams)

- `GET /teams` - List user's teams
- `POST /teams` - Create new team
- `PUT /teams/{id}` - Update team
- `DELETE /teams/{id}` - Delete team

### Team Members

[](#team-members)

- `GET /teams/{id}/members` - List team members
- `POST /teams/{id}/members` - Add team member
- `PUT /teams/{id}/members/{id}` - Update member role
- `DELETE /teams/{id}/members/{id}` - Remove member

### Files

[](#files)

- `GET /teams/{id}/files` - List team files
- `POST /teams/{id}/files` - Upload file
- `DELETE /teams/{id}/files/{id}` - Delete file

📚 Documentation
---------------

[](#-documentation)

### Laravel Packages

[](#laravel-packages)

- [Laravel Documentation](https://laravel.com/docs)
- [Laravel Fortify](https://laravel.com/docs/fortify) - Authentication backend
- [Laravel Sanctum](https://laravel.com/docs/sanctum) - API authentication
- [Laravel Cashier](https://laravel.com/docs/cashier) - Payment processing
- [Laravel Reverb](https://laravel.com/docs/reverb) - WebSocket server

### Frontend

[](#frontend-1)

- [Inertia.js](https://inertiajs.com/) - Server-driven SPA
- [React Documentation](https://react.dev)
- [TypeScript](https://www.typescriptlang.org/)
- [Tailwind CSS](https://tailwindcss.com/)
- [Radix UI](https://www.radix-ui.com/)

🚨 Troubleshooting
-----------------

[](#-troubleshooting)

### Common Issues

[](#common-issues)

**Port 3000 already in use**

```
# Kill process on port 3000
lsof -i :3000 | grep LISTEN | awk '{print $2}' | xargs kill -9
# Or use a different port
pnpm run dev -- --port 3001
```

**Database connection error**

- Verify `.env` database credentials
- Ensure database server is running
- Check database user permissions

**Node modules issues**

```
rm -rf node_modules pnpm-lock.yaml
pnpm install
```

**Composer issues**

```
composer clear-cache
composer install
```

📝 Development Workflow
----------------------

[](#-development-workflow)

1. **Create Feature Branch**

    ```
    git checkout -b feature/feature-name
    ```
2. **Make Changes**

    - Follow PSR-12 PHP coding standards (enforced by Pint)
    - Follow ESLint rules for JavaScript/TypeScript
    - Write tests for new features
3. **Run Code Quality Checks**

    ```
    composer pint
    pnpm run lint
    pnpm run format
    pnpm run types:check
    ./vendor/bin/pest
    ```
4. **Commit and Push**

    ```
    git add .
    git commit -m "feat: description of changes"
    git push origin feature/feature-name
    ```
5. **Create Pull Request**

🔒 Security Considerations
-------------------------

[](#-security-considerations)

- Keep Laravel and dependencies updated
- Use HTTPS in production
- Configure CORS properly for API requests
- Implement rate limiting on sensitive endpoints
- Use strong database passwords
- Keep Stripe keys secure and never commit them
- Regular security audits and vulnerability scanning
- Enable CSRF protection (default in Laravel)
- SQL injection protection via Eloquent ORM

📄 License
---------

[](#-license)

This project is open-source software licensed under the [MIT license](LICENSE).

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please follow the development workflow:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Ensure all tests pass and code style is correct
5. Commit with clear messages
6. Push to your fork
7. Submit a pull request

📞 Support
---------

[](#-support)

For questions or issues, please:

- Check existing [Issues](https://github.com/hytek-org/framex/issues)
- Create a new issue with detailed information
- Contact the development team

🎉 Acknowledgments
-----------------

[](#-acknowledgments)

Built with:

- [Laravel](https://laravel.com) - The PHP Framework
- [React](https://react.dev) - UI Library
- [Inertia.js](https://inertiajs.com/) - Modern SPA Framework
- [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS
- [Radix UI](https://www.radix-ui.com/) - Headless Components

---

**Last Updated:** May 2026 **Version:** 1.0.0

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance77

Regular maintenance activity

Popularity8

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 98.1% 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.

###  Release Activity

Cadence

Every ~272 days

Total

2

Last Release

26d ago

PHP version history (2 changes)v1.0.0PHP ^8.2

v1.1.0PHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5228208?v=4)[hytek](/maintainers/hytek)[@Hytek](https://github.com/Hytek)

---

Top Contributors

[![kuldeepsharma1](https://avatars.githubusercontent.com/u/92307408?v=4)](https://github.com/kuldeepsharma1 "kuldeepsharma1 (52 commits)")[![ImgBotApp](https://avatars.githubusercontent.com/u/31427850?v=4)](https://github.com/ImgBotApp "ImgBotApp (1 commits)")

---

Tags

laravel-frameworkstarter-kitlaraveltypescriptinertiasaasstarter-kitcashierreverbframex

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/hytek-framex/health.svg)

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

###  Alternatives

[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[bagisto/bagisto

Bagisto Laravel E-Commerce

27.6k172.1k9](/packages/bagisto-bagisto)[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)[nunomaduro/laravel-starter-kit-inertia-react

The skeleton application for the Laravel framework.

2071.1k](/packages/nunomaduro-laravel-starter-kit-inertia-react)

PHPackages © 2026

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