PHPackages hitaqnia/haykal-starter - 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. hitaqnia/haykal-starter ActiveProject[Framework](/categories/framework) hitaqnia/haykal-starter ======================= HiTaqnia Laravel app starter — Haykal pre-wired, Huwiya-backed authentication, ready to grow into any new project. v1.0.0(1mo ago)06proprietaryPHPPHP ^8.3 Since Apr 25Pushed 1mo agoCompare [ Source](https://github.com/hitaqnia/haykal-starter)[ Packagist](https://packagist.org/packages/hitaqnia/haykal-starter)[ RSS](/packages/hitaqnia-haykal-starter/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (17)Versions (2)Used By (0) Haykal Starter ============== [](#haykal-starter) A Laravel 13 starter pre-wired with the [Haykal](https://github.com/hitaqnia/haykal) suite — Huwiya authentication, Filament-ready base, REST API envelope, Spatie permissions, and a complete Docker dev stack. Clone it as the starting point for any new HiTaqnia project. Quick start ----------- [](#quick-start) Prerequisites: Docker Desktop (or any Docker Engine) and `make`. ``` make setup # build images, install deps, migrate make docker-up # subsequent sessions ``` Once running: - App — - Mailpit — - MinIO console — (`minio` / `minio123`) - Postgres — `localhost:5432` (db `haykal`, user/pass `postgres`) Renaming the project -------------------- [](#renaming-the-project) Every container, image, and volume is prefixed with `APP_SLUG` (default `haykal-app`). Rename in one shot: ``` make docker-down make rename-project NAME=my-new-project make docker-rebuild make setup ``` Common commands --------------- [](#common-commands) ``` make docker-shell # shell into the app container make docker-logs # tail app logs make docker-psql # psql into the database make migrate # run migrations make migrate-fresh # drop everything and re-migrate make seed # run seeders make test # php artisan test make tinker # php artisan tinker make artisan # passthrough, e.g. make artisan route:list make vite # vite dev server make build-fe # production frontend build ``` Full list: `make help`. Configuration ------------- [](#configuration) Edit `.env.docker` for the Dockerized stack (or `.env` for non-Docker). The two things you must fill in before the app can authenticate: ``` HUWIYA_URL=https://your-huwiya-instance.example HUWIYA_PROJECT_ID=... HUWIYA_CLIENT_ID=... HUWIYA_CLIENT_SECRET=... HUWIYA_REDIRECT_URI=https://your-app.example/huwiya/callback ``` `APP_KEY` is generated automatically by the container entrypoint on first start. Host ports are overridable in `.env.docker` — useful when 8000/5432/6379 are already taken: ``` APP_PORT=8100 POSTGRES_PORT=5532 REDIS_PORT=6479 ``` What's wired up --------------- [](#whats-wired-up) - **Auth** — Huwiya guards (`huwiya-web`, `huwiya-api`) wired in `config/auth.php`. The `User`, `Role`, and `Permission` models live in `domain/Identity/Models/` and are owned by the app — edit them directly. - **Schema** — Migrations under `database/migrations/` ship with `users`, `sessions`, Spatie permission tables (ULID-keyed, teams disabled), Media Library, and notifications. - **API** — Haykal response envelope is registered. Add modules by subclassing `HiTaqnia\Haykal\Api\ApiProvider`. No modules ship by default. - **Filament** — `BasePanel` is available. No panels ship by default. Register them in `bootstrap/providers.php`. - **Middleware** — `haykal.permissions.team` alias available for tenant-scoped routes (not registered globally). Project layout -------------- [](#project-layout) ``` app/ Laravel framework glue (providers, HTTP, Filament). domain/ DDD bounded contexts. Identity ships pre-wired. support/ App-wide utilities. Empty — add as needed. packages/ In-tree path repositories. Empty. deployment/ Dockerfile, php.ini, container entrypoint. docker-compose.yaml app + horizon + scheduler + postgres + redis + minio + mailpit. Makefile setup / docker-* / migrate / artisan / rename-project. ``` Autoload roots: `App\` → `app/`, `Domain\` → `domain/`, `Support\` → `support/`. Next steps ---------- [](#next-steps) When you're ready to build the actual app: 1. Define your tenant model(s) by extending `HiTaqnia\Haykal\Core\Tenancy\Models\Tenant`. 2. Mark tenant-owned models with the `HasTenant` trait. 3. Create Filament panels by subclassing `HiTaqnia\Haykal\Filament\BasePanel` and registering them in `bootstrap/providers.php`. 4. Define `.access` Gates in `AppServiceProvider::boot()`. 5. Add API modules by subclassing `HiTaqnia\Haykal\Api\ApiProvider`. 6. Customize `domain/Identity/Models/User.php` — add columns, relations, and Huwiya claim hooks inline. Documentation ------------- [](#documentation) PackageRepository`haykal` (metapackage)`haykal-core` (tenancy, permissions, result pattern)`haykal-api` (REST conventions, envelope, Scramble)`haykal-filament` (BasePanel, BaseResource, themes)License ------- [](#license) Proprietary. Property of HiTaqnia. ### Health Score 40 — FairBetter than 86% of packages Maintenance92 Actively maintained with recent releases Popularity4 Limited adoption so far Community6 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 45d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a71357d99589a129a83cc144fbde6250fce3f3d0fa3f442770ef79f47ed7d9b2?d=identicon)[mahdi-mk](/maintainers/mahdi-mk) --- Top Contributors [![mahdi-mk](https://avatars.githubusercontent.com/u/48333830?v=4)](https://github.com/mahdi-mk "mahdi-mk (13 commits)") ### Code Quality TestsPHPUnit Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/hitaqnia-haykal-starter/health.svg) ``` [![Health](https://phpackages.com/badges/hitaqnia-haykal-starter/health.svg)](https://phpackages.com/packages/hitaqnia-haykal-starter) ``` ### Alternatives [unopim/unopim UnoPim Laravel PIM 10.1k2.2k](/packages/unopim-unopim)[nasirkhan/laravel-starter A CMS like modular Laravel starter project. 1.4k2.7k](/packages/nasirkhan-laravel-starter)[bagisto/bagisto Bagisto Laravel E-Commerce 26.9k169.0k9](/packages/bagisto-bagisto) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)