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 modern, full-stack starter kit built for rapid, scalable web development. Combining the power of Laravel with a React + TypeScript frontend, FrameX gives developers a rock-solid foundation to launch blogs, dashboards, communities, and SaaS platforms with ease.

v1.0.0(8mo ago)07MITTypeScriptPHP ^8.2CI failing

Since Sep 7Pushed 8mo ago1 watchersCompare

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

READMEChangelog (1)Dependencies (14)Versions (2)Used By (0)

FrameX: Advanced Full-Stack Laravel-React Starter Kit
=====================================================

[](#framex-advanced-full-stack-laravel-react-starter-kit)

[![GitHub license](https://camo.githubusercontent.com/73df6b4d9c91363a420a56f30e6feb3e5ab330770650fbfbb1471a23259bb761/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f687974656b2d6f72672f6672616d65783f7374796c653d666c61742d737175617265)](https://github.com/hytek-org/framex/blob/main/LICENSE)[![GitHub stars](https://camo.githubusercontent.com/c7f11c10bbfe24370ce37e1c67430e5677f93b575f596d86852c87a7843a6795/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f687974656b2d6f72672f6672616d65783f7374796c653d666c61742d737175617265)](https://github.com/hytek-org/framex/stargazers)[![GitHub issues](https://camo.githubusercontent.com/b8e0da191752d91b72a8072838e572fa9cc66600e3dfe17819bc0cc54321fa06/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f687974656b2d6f72672f6672616d65783f7374796c653d666c61742d737175617265)](https://github.com/hytek-org/framex/issues)[![Laravel Version](https://camo.githubusercontent.com/e2ab74c900c407c3d7b80cd3689bb5c8f2767230a906c7b2c1e6f0ff8da66157/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322e782d7265643f7374796c653d666c61742d737175617265)](https://laravel.com/docs/12.x)[![React Version](https://camo.githubusercontent.com/2840ad43a4195fb9c6a6f30ac965ada26c577b8378910dcf684882ea94dc1edc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f52656163742d31392e312d626c75653f7374796c653d666c61742d737175617265)](https://react.dev/)[![TypeScript Version](https://camo.githubusercontent.com/806cdb52f42cc1de28d875bd19d8b24cc57b3516bf0e868ff33a64d869fa1b60/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547970655363726970742d352e392d677265656e3f7374796c653d666c61742d737175617265)](https://www.typescriptlang.org/)

FrameX is a production-ready, enterprise-grade full-stack boilerplate designed to accelerate the development of scalable web applications. Leveraging the robustness of Laravel for backend operations and the reactivity of React with TypeScript for the frontend, FrameX incorporates best practices for security, performance, and maintainability. It extends beyond basic starters by integrating advanced features like role-based access control (RBAC), payment processing, API versioning, and containerized deployment workflows.

This template is ideal for building SaaS platforms, enterprise dashboards, e-commerce systems, content management platforms, and collaborative communities. By adhering to modern development paradigms—such as API-first design, server-side rendering (SSR) via Inertia.js, and utility-first styling—FrameX reduces boilerplate code while ensuring compliance with standards like OWASP for security and WCAG for accessibility.

Key Features
------------

[](#key-features)

FrameX distinguishes itself through a comprehensive set of production-oriented features, drawing from 2025 best practices for Laravel-React stacks:

- **Authentication &amp; Authorization**: Full scaffolding with Laravel Sanctum for SPA authentication, email verification, password resets, and OAuth providers (e.g., Google, GitHub). RBAC implemented via Spatie's Permissions package, supporting granular roles like admin, user, and guest.
- **API Excellence**: RESTful APIs with rate limiting, versioning (e.g., `/api/v1/`), and automatic OpenAPI/Swagger documentation. GraphQL support via Lighthouse for complex queries, ensuring flexibility for headless architectures.
- **Admin Dashboard**: Integrated Filament-inspired panel for CRUD operations, real-time analytics, and user management, with customizable themes.
- **Payments &amp; Subscriptions**: Seamless Stripe integration for one-time payments, recurring subscriptions, invoicing, and webhooks handling.
- **Frontend Enhancements**: React with TypeScript for type-safe components, Inertia.js for SSR/SPA hybrid, and shadcn/ui + Radix UI for accessible, customizable UI primitives. Tailwind CSS for responsive styling.
- **Performance Optimizations**: Lazy loading, code splitting via Vite, Redis caching, and queue management with Horizon. Database indexing and query optimization best practices baked in.
- **Security Best Practices**: CSRF/XSS protection, input sanitization, encryption at rest, and automated vulnerability scanning hooks in CI/CD. Follows Laravel's security guidelines and React's secure context usage.
- **Testing &amp; Quality Assurance**: Comprehensive coverage with PHPUnit for backend, Vitest/Jest for frontend, and Cypress for E2E tests. Linting via ESLint, PHPStan, and Prettier.
- **Deployment &amp; Scalability**: Dockerized environment for local development and production, Kubernetes manifests for orchestration, and zero-downtime deployment scripts using Envoy or GitHub Actions.
- **SEO &amp; Internationalization**: Automated sitemap generation, meta tags for Open Graph/Twitter Cards, and i18n support with Laravel localization and React-i18next.
- **Analytics &amp; Monitoring**: Pre-configured hooks for Google Analytics, Sentry for error tracking, and Laravel Telescope for debugging.
- **Modularity &amp; Extensibility**: Modular architecture with feature-based folder structure (e.g., `app/Features/`), allowing easy addition of microservices or third-party integrations like AI APIs (e.g., OpenAI).

These features align with 2025 trends, emphasizing headless APIs, composable UIs, and cloud-native deployments for high-performance applications.

Technology Stack
----------------

[](#technology-stack)

FrameX uses cutting-edge versions as of August 2025 for optimal compatibility and features:

ComponentVersionPurpose**Backend**Laravel12.xCore PHP framework for routing, ORM, queuing, and API development.PostgreSQL/MySQLLatest LTSRelational database with migrations and seeders.Redis7.xCaching and session management.**Frontend**React19.1Component-based UI library with hooks and context API.TypeScript5.9Type-safe JavaScript superset for maintainable code.Inertia.js2.0.17Bridge for SSR/SPA without custom client-side routing.Tailwind CSS4.0Utility-first CSS for rapid, responsive styling.shadcn/uiCLI 3.0Customizable UI components with accessibility focus.Radix UI1.4.3Unstyled primitives for building complex UIs.**Build Tools**Vite5.xFast frontend bundler with HMR.DockerLatestContainerization for environments.**Testing**PHPUnit11.xBackend unit/integration tests.Vitest1.xFrontend testing with React support.Cypress13.xEnd-to-end browser testing.Prerequisites
-------------

[](#prerequisites)

Before installation, ensure your system meets these requirements:

- PHP &gt;= 8.3 (with extensions: pdo, mbstring, xml, curl, gd, zip)
- Composer &gt;= 2.7
- Node.js &gt;= 20.x with npm/yarn/pnpm
- Docker (for containerized setup)
- Git for version control
- A database server (PostgreSQL recommended for advanced features)

Installation
------------

[](#installation)

Follow these steps to set up FrameX locally. This process incorporates best practices for secure and efficient setup.

1. **Clone the Repository**:

    ```
    git clone https://github.com/hytek-org/framex.git
    cd framex

    ```
2. **Install Backend Dependencies**:

    ```
    composer install --optimize-autoloader --no-dev

    ```
3. **Install Frontend Dependencies**:

    ```
    npm install  # or yarn/pnpm

    ```
4. **Configure Environment**: Copy `.env.example` to `.env` and update keys:

    ```
    cp .env.example .env

    ```

    Set database credentials, Stripe keys, etc. Generate app key:

    ```
    php artisan key:generate

    ```
5. **Run Migrations and Seeders**:

    ```
    php artisan migrate --seed

    ```
6. **Build Assets**:

    ```
    npm run build  # Production build
    # or npm run dev for development with HMR

    ```
7. **Start the Server**:

    ```
    php artisan serve

    ```

    Access at `http://localhost:8000`.

Docker Configuration (Coming Soon)
----------------------------------

[](#docker-configuration-coming-soon)

A flexible, container-based development setup is on the way! Soon, you’ll be able to spin up your full environment using:

You’ll be able to initiate all services effortlessly with:

```
docker-compose up -d
```

Configuration
-------------

[](#configuration)

### Environment Variables

[](#environment-variables)

Key `.env` settings (with explanations):

- `APP_ENV=local/production`: Environment mode; use `production` for optimized caching.
- `DB_CONNECTION=pgsql`: Prefer PostgreSQL for JSONB support in advanced queries.
- `STRIPE_KEY=sk_test_...`: For payments; ensure webhooks are configured at `/stripe/webhook`.
- `CACHE_DRIVER=redis`: Enables horizontal scaling.
- `QUEUE_CONNECTION=redis`: For background jobs like email sending.

### Customizing UI

[](#customizing-ui)

Add shadcn/ui components:

```
npx shadcn@latest add button

```

This follows 2025 best practices for composable UIs.

### API Versioning

[](#api-versioning)

Routes in `routes/api.php` use prefixes:

```
Route::prefix('v1')->group(function () {
    // API endpoints
});
```

Usage
-----

[](#usage)

### Running in Development

[](#running-in-development)

- Backend: `php artisan serve`
- Frontend: `npm run dev`
- Tests: `php artisan test` (backend) / `npm test` (frontend)

### Building a Feature

[](#building-a-feature)

Example: Adding a new dashboard page.

1. Create Laravel controller: `app/Http/Controllers/DashboardController.php`

    ```
    namespace App\Http\Controllers;

    use Inertia\Inertia;

    class DashboardController extends Controller
    {
        public function index()
        {
            return Inertia::render('Dashboard', [
                'metrics' => auth()->user()->metrics(),
            ]);
        }
    }
    ```
2. Define React component: `resources/js/Pages/Dashboard.tsx`

    ```
    import { usePage } from '@inertiajs/react';
    import { Card } from '@/components/ui/card';

    export default function Dashboard() {
        const { metrics } = usePage().props as { metrics: any };

        return (

                Dashboard Metrics: {metrics.count}

        );
    }
    ```
3. Add route: `routes/web.php`

    ```
    Route::get('/dashboard', [DashboardController::class, 'index'])->middleware('auth');
    ```

This exemplifies the Inertia.js flow for seamless full-stack integration.

### Deployment

[](#deployment)

Use GitHub Actions workflow (`.github/workflows/deploy.yml`) for CI/CD:

- Tests on push
- Deploy to production on merge

For Kubernetes: Apply `k8s/deployment.yaml` for scaled pods.

API Documentation
-----------------

[](#api-documentation)

Access Swagger at `/api/docs`. Example endpoint:

- `GET /api/v1/users`: List users (authenticated). Generated via Laravel's built-in tools for maintainable APIs.

Contributing
------------

[](#contributing)

We welcome contributions! Follow these steps:

1. Fork the repo.
2. Create a feature branch: `git checkout -b feature/new-feature`.
3. Commit changes: `git commit -m 'Add new feature'`.
4. Push: `git push origin feature/new-feature`.
5. Open a Pull Request.

Adhere to PSR-12 for PHP and Airbnb style for JS/TS. Include tests for new features.

License
-------

[](#license)

FrameX is open-sourced under the [MIT License](LICENSE). Feel free to use, modify, and distribute.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance60

Regular maintenance activity

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

253d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6d559abbf72c50773b26920de62366901405f032a4b81ad4eeb7d6a0abc54e9c?d=identicon)[hytek](/maintainers/hytek)

---

Top Contributors

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

---

Tags

laravel-frameworkstarter-kitframeworklaravelframex

###  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

[bagisto/bagisto

Bagisto Laravel E-Commerce

26.2k161.6k7](/packages/bagisto-bagisto)[unopim/unopim

UnoPim Laravel PIM

9.4k1.8k](/packages/unopim-unopim)[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)[codewithdennis/larament

Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow.

3691.5k](/packages/codewithdennis-larament)

PHPackages © 2026

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