Migrating from Laravel

Pondoknusa borrows Laravel's mental model — routes, middleware, Eloquent-style models, queues, and views — while targeting TypeScript and Node.js 26+ (or Bun). This guide maps familiar Laravel concepts to Pondoknusa equivalents.

Application bootstrap

Laravel	Pondoknusa
bootstrap/app.php	src/main.ts + src/providers/app-service-provider.ts
config/*.php	config/*.ts with typed env() and optional schema
.env	.env (same idea; validated on boot)
serve	pondoknusa dev or pondoknusa serve
CLI	pondoknusa CLI (migrate, make:*, queue:work, …)

Routing

Laravel	Pondoknusa
routes/web.php	src/routes/web.ts
Route::get('/', …)	Route.get('/', …) from @pondoknusa/core
Route model binding	request.routeModel('post')
route:list	pondoknusa route:list
route:cache	pondoknusa route:cache

Controllers are TypeScript classes with async methods. Invokable controllers use __invoke.

Views

Laravel	Pondoknusa
Blade (.blade.php)	TSX views (.tsx)
@extends, @section	Layout components such as <AppLayout>
<x-alert /> components	<Alert message={…} />
Livewire / islands	<Island id="…"> + client registerIsland()
Programmatic UI	Default-exported render() in .tsx

Run pondoknusa view:types for typed props (ViewPropsMap). TypeScript checks the view modules.

Eloquent → models

Laravel	Pondoknusa
User::find(1)	await User.find(1)
$user->posts()	user.posts() relation helpers
Migrations	database/migrations/*.ts + pondoknusa migrate
Factories / seeders	pondoknusa make:factory, pondoknusa db:seed
Soft deletes	static softDeletes = true on models

Models live in src/models/ and extend Model from @pondoknusa/database.

Auth

Laravel	Pondoknusa
install:api / Breeze	pondoknusa auth:install
Socialite	Built-in OAuth drivers in @pondoknusa/auth
Auth::user()	Auth.user() facade
Gates / policies	Gate + policy classes

Queues & events

Laravel	Pondoknusa
ShouldQueue listeners	Queue-backed listeners via @pondoknusa/queue
queue:work	pondoknusa queue:work or pondoknusa dev
event() / Event::dispatch	Events.dispatch()
Bus::dispatch	Bus.dispatch() with auto-resolved handlers

Register explicit handlers with Bus.register(Command, Handler) when you prefer explicit wiring over convention.

Mail & notifications

Laravel	Pondoknusa
Mailable classes	Classes implementing mail contracts in @pondoknusa/mail
make:notification	pondoknusa make:notification (via notifications package)
MAIL_MAILER=log	Same env key; log driver for local dev

Testing

Laravel	Pondoknusa
PHPUnit / Pest	Vitest + @pondoknusa/testing
test	pondoknusa test
$this->get('/')	test.http.get('/') with assertion helpers
actingAs($user)	test.http.actingAs(user)

See Testing for HTTP recipes, queue draining, and parallel Vitest workspaces.

Deployment

Laravel	Pondoknusa
config:cache	pondoknusa config:cache / config:clear
view:cache	pondoknusa view:cache
Forge / Vapor patterns	deploy/ scaffold (Docker, Fly, Railway)
Health checks	/health/live and /health/ready

Run pondoknusa deploy:check before shipping to validate doctor checks, route compilation, and view cache.

Debugging

Laravel	Pondoknusa
Telescope (paid/complex)	pondoknusa debug:install + debug bar; /__debug requires auth — use debug:watch locally
Query log	Debug bar query count + N+1 warnings
tinker	pondoknusa shell (.routes, .models, persistent history)

Suggested first steps

1. npm create pondoknusa@latest or pondoknusa new my-app --template=saas
2. pondoknusa migrate and pondoknusa dev
3. Port routes from routes/web.php to src/routes/web.ts
4. Convert Blade layouts to .tsx views. See Views.
5. Move models and migrations; run pondoknusa test

For a working reference app, see examples/hello-world and examples/saas-starter.