Search by 
naykel / postit
Post management package for NayKel Laravel Applications
v0.1.0
2025-05-27 04:38 UTC
Requires
- php: ^8.2
- livewire/livewire: ^3.6
- spatie/laravel-sluggable: ^3.7
Requires (Dev)
- laravel/pint: ^1.14
- nunomaduro/collision: ^8.1.1||^7.10.0
- orchestra/testbench: ^10.0.0||^9.0.0||^8.22.0
- pestphp/pest: ^3.0
- pestphp/pest-plugin-arch: ^3.0
- pestphp/pest-plugin-laravel: ^3.0
README
Naykel Postit
To Do's / Testing Checklist
Routing & Access
- it protects admin routes from unauthorised access
- it redirects unauthenticated users to login when accessing protected routes
- it prevents non-admin users from accessing post creation or editing routes
- it moves post routes to the admin group
Post Table
- it displays a searchable post table
- it filters posts in the table
- it sorts posts in the table
- it paginates the post table
- it handles empty search and filter states gracefully
Creating posts is disabled until such time as we work out the routing system and access control.
CRUD Operations
- it creates a post with valid data
- it reads a post and displays its details
- it updates a post with new data
- it deletes a post
- it handles optional fields gracefully (intro, headline, body, image, extras)
- it validates required fields when creating or updating a post
it checks
Slug Handling
- it ensures slugs are unique and auto-generated
- it prevents manual slug override if slug auto-generation is enforced
- it allows custom slugs when explicitly provided
Publishing
- it toggles the published status of a post
- it displays the correct status label and colour for each post
Layout & Views
- it selects and renders the correct layout for a post
- it returns the correct view for each layout in the ShowPostController
- it loads custom local views when available
Form Behaviour (UI)
- it shows a message when the form is dirty and the user tries to leave the page
- it preserves form input on validation errors
- it clears the form after successful post creation
- it focuses the first invalid field on validation failure
Image Handling
- it uploads and stores images correctly
- it replaces the existing image when uploading a new one
- it deletes the old image file from storage when updated
- it removes associated images when a post is deleted
Soft Deletes (if applicable)
- it moves posts to the trash instead of permanently deleting
- it restores soft-deleted posts
- it permanently deletes trashed posts
Factories & Fixtures
- it generates valid post data using the factory
- it generates factory data that matches all validation rules
- it includes all optional fields in factory output when requested
Livewire / Component Behaviour (if used)
- it renders the post creation component correctly
- it handles form submission in Livewire without a page reload
- it shows real-time validation feedback in the Livewire form
Service Provider
- it creates the correct database schema via migration
- it loads package views, migrations, and routes
- it merges package config correctly (if applicable)
- it publishes config, views, and assets using artisan