postn Docs - Installation Guide

info What's Included with postn

Customer Website — React + Vite frontend for buyers and sellers
Admin Panel — Filament dashboard for complete management
Laravel API — Secure backend with authentication and role management
Authentication — Login, Register, and Email OTP Password Reset
Roles & Permissions — Filament Shield with Super Admin, Admin, Moderator, Content Manager
Email Integration — SMTP for OTP, notifications, and communications

All core marketplace features are self-contained. No payment gateways, map services, or SMS services are required.

info

What comes with postn

Customer Website, Admin Panel, and Laravel API — all included. No additional third-party services required.

Introduction

Welcome to postn, a complete end-to-end OLX-style classified marketplace platform built with modern technologies. It enables users to buy and sell items locally with ease, featuring a seamless frontend experience, robust backend API, and powerful admin panel. Designed for entrepreneurs, businesses, and organizations looking to launch or scale their marketplace operations.

Core Features

lock Authentication Module

Login with Email & Password
Remember Me functionality
Show/Hide Password toggle
User Registration with phone number

Forgot Password with Email OTP
OTP Expiry & Verification
Password Reset flow
Admin authentication with Filament Shield

storefront Marketplace Features

Dynamic Categories & Subcategories
Dynamic Attributes by Subcategory
Multi-Image Upload (10 images)
Featured Listings

Wishlist & Saved Searches
Search Alerts
Grid/List View toggle
Advanced Filters

Listing Moderation workflow
Status History (Audit Trail)
Seller Contact (Call/Email)
Mark as Sold functionality

admin_panel_settings Admin Panel Features

Dashboard Analytics
Customer Management
User & Role Management
Category/Subcategory CRUD

Attribute & Brand Management
Listing Moderation
CMS (Blog, About, FAQ, Policies)
Contact Message Management

Newsletter Campaigns
City Management
Dynamic App Settings
Bulk Actions

check_circle

White-Label Solution

This platform is distributed as a white-label solution, allowing complete customization of branding, configurations, categories, and content to match your business requirements and scale your marketplace operations efficiently.

Getting Started

Third-Party Services

Email (SMTP/Gmail) — Required for OTP, notifications, password reset, and admin communications
Laravel Sanctum — API authentication (included with Laravel)
Spatie Laravel Permission — Role-based access control (included with Laravel)
Filament Shield — Admin panel security and permissions (included with Filament)
Database Queue — Background job processing for emails (included with Laravel)

No payment gateways, map services, SMS services, or push notification services are required.

lightbulb

Prerequisite Knowledge

Basic understanding of React-based website development, Laravel backend setup, and API integration is recommended before installation and customization.

hub Third Party Services

hub Third Party Services & Integrations

postn integrates with essential third-party services to provide email delivery, authentication, role management, and background job processing. These services are included as Laravel packages and require minimal configuration. Email services require your own SMTP/Gmail credentials.

Service	Status	Purpose
Email (SMTP/Gmail)	Requires Setup	Sends OTP codes, seller inquiries, newsletters, password reset emails, and admin replies. Requires your own SMTP or Gmail credentials.
Laravel Sanctum	Active	Provides secure API authentication using personal access tokens for frontend, mobile, or external applications. Included with Laravel.
Spatie Laravel Permission	Active	Manages roles and permissions for users and administrators using role-based access control (RBAC). Included as a Laravel package.
Filament Shield	Active	Controls authorization and permission management for the Filament admin panel. Included with the Filament package.
Database Queue	Active	Processes background jobs such as newsletter email delivery and other queued tasks asynchronously. Included with Laravel.

info Status Legend

Active - Service is operational (included with Laravel)

Requires Setup - Service needs your own credentials

Included - Service comes with the Laravel framework

info Important Notice

What's Included: Laravel Sanctum, Spatie Laravel Permission, Filament Shield, and Database Queue are all included with the Laravel/Filament installation and require no additional subscriptions or payments.

What You Need: Only email service (SMTP/Gmail) requires your own credentials. No payment gateways, SMS services, map services, or push notification services are required for postn to function.

Hosting: Web hosting, domain registration, and SSL certificates are the responsibility of the buyer and are not included with the purchase.

dns Environmental Setup

verified Version Requirements

Ensure the following software versions are installed before proceeding:

Backend Requirements

PHP: 8.3 or later
Laravel: 13.x
MySQL: 8.0 or later
Composer: 2.x or later
Apache/Nginx: Latest stable version

Frontend Requirements

Node.js: 20.x or later
npm: 10.x or later
React: 19.2.8
Vite: 8.x
Tailwind CSS: 4.x

warning Important: Using older versions may cause compatibility issues. Always use the recommended versions.

System Requirements

Operating System:

Windows 10/11 (64-bit) — Pro or Enterprise recommended
macOS Monterey (12.0) or later — Sonoma 14.5+ recommended
Linux (Ubuntu 22.04 LTS, 24.04 LTS, or equivalent)

Minimum Hardware:

Processor: Intel i5 10th Gen (or AMD Ryzen 5) or better
RAM: 4 GB (minimum), 8 GB recommended
Storage: 5 GB free disk space for dependencies and build files
Internet: Broadband connection required for downloading dependencies

Software Requirements

Tool/Software	Minimum Version	Recommended Version	Purpose
PHP	8.3	8.3+	Laravel backend
Laravel	13.8	13.x	PHP Framework
React	19.2.8	19.x	UI Library
Node.js	18+	20+	React & npm scripts
MySQL	8.0	8.0+	Database
Composer	2.x	2.x	PHP dependency manager
npm	9+	10+	Package management
Vite	8.0	8.x	Build tool & development server
Tailwind CSS	4.0	4.x	Utility-first CSS framework
Git	2.30	Latest	Version control (optional)
VS Code	1.80	Latest	Code editor (recommended)
Web Browser	Chrome 120, Firefox 120, Edge 120	Latest version	Testing & debugging

Laravel Dependencies


{
    "require": {
        "php": "^8.3",
        "bezhansalleh/filament-shield": "^4.3",
        "filament/filament": "^5.0",
        "inertiajs/inertia-laravel": "^3.1",
        "laravel/framework": "^13.8",
        "laravel/sanctum": "^4.3",
        "laravel/tinker": "^3.0",
        "spatie/laravel-permission": "^8.3",
        "wireui/heroicons": "^2.10"
    },
    "require-dev": {
        "fakerphp/faker": "^1.23",
        "laravel/pail": "^1.2.5",
        "laravel/pao": "^1.0.6",
        "laravel/pint": "^1.27",
        "mockery/mockery": "^1.6",
        "nunomaduro/collision": "^8.6",
        "phpunit/phpunit": "^12.5.12"
    }
}

React Dependencies


{
    "dependencies": {
        "@dnd-kit/core": "^6.3.1",
        "@dnd-kit/sortable": "^10.0.0",
        "@dnd-kit/utilities": "^3.2.2",
        "@inertiajs/react": "^3.6.1",
        "@vitejs/plugin-react": "^6.0.4",
        "lucide-react": "^1.26.0",
        "react": "^19.2.8",
        "react-dom": "^19.2.8",
        "react-easy-crop": "^6.2.3",
        "react-phone-number-input": "^3.4.17",
        "sonner": "^2.0.7",
        "swiper": "^14.0.6"
    }
}

XAMPP / Local Server Installation

Download XAMPP from apachefriends.org (version 8.2+ recommended)
Install XAMPP on your system with default settings
After installation, start Apache and MySQL services from the XAMPP control panel
Verify installation by visiting http://localhost in your browser

info

Alternative Local Servers:

Laragon (Windows) - Faster and lighter alternative
MAMP (macOS/Windows) - Easy to use
Docker (All platforms) - Containerized environment
Valet (macOS) - Laravel native development

Composer Installation

Download Composer from getcomposer.org
Install Composer on your system

info

Composer Installation Guide:

https://youtu.be/VCHXCusltqI?si=EfH3PW6l0sRS0FbE

Getting Started Requirements

lightbulb

Note: It's necessary to have a basic knowledge in both server side and frontend development.

Basic knowledge of React-based website development
Basic knowledge of Laravel backend setup and API integration
Understanding of database management (MySQL)

terminal

Verify Your Installation

Run these commands in your terminal/command prompt to confirm all required tools are properly installed:


# Check Node.js version
node --version   # Should show v20.x or higher

# Check npm version
npm --version    # Should show v10.x or higher

# Check PHP version
php --version    # Should show 8.3 or higher

# Check Composer version
composer --version  # Should show 2.x or higher

# Check MySQL version
mysql --version  # Should show 8.0 or higher

check_circle

Success Indicator:

If all commands show the correct versions (or higher), your environment is ready for installation.

error

Troubleshooting:

If any command returns "not found" or shows an older version, please install or update the corresponding software before proceeding.

memory Technology Stack

memory Complete Technology Stack

postn is built using modern and scalable technologies to power Customer Website and Administrative operations.

Core Technology Versions

Before installing and running the application, ensure the following technologies and tools are installed with the recommended versions.

Tool/Software	Minimum Version	Recommended Version
PHP	8.3	8.3+
Laravel	13.8	13.x
React	19.2.8	19.x
Node.js	18+	20+
MySQL	8.0	8.0+
Composer	2.x	2.x
npm	9+	10+
Vite	8.0	8.x
Tailwind CSS	4.0	4.x

Category	Technology	Version	Purpose
Frontend (Customer Website)
Framework	React	19.2.8	UI Library
Build Tool	Vite	8.x	Build tool & development server
CSS Framework	Tailwind CSS	4.x	Utility-first CSS framework
Routing	React Router DOM	7.18.1	Page navigation
JavaScript Library	Alpine.js	3.15.12	Interactive UI Components
Map Library	MapLibre GL	4.7.1	Map Rendering & Location Services
Backend (Admin Panel & API)
Language	PHP	8.3+	Server-Side Programming
Framework	Laravel	13.x	PHP Framework
Admin Panel	Filament	5.6	Admin Dashboard
Admin Security	Filament Shield	4.2	Admin Panel Security & Permissions
Role & Permission	Spatie Laravel Permission	7.4	User Roles & Permissions Management
Database	MySQL / MariaDB	8.0+ / 10.6+	Relational Database
Dependency Manager	Composer	2.x	PHP Package Management

Hosting & Production Server Requirements

Apache 2.4+ or Nginx 1.18+
PHP 8.3+
MySQL 8.0+ / MariaDB 10.6+
SSL Certificate (HTTPS) Recommended
Cron Job Support
Minimum 4 GB RAM (8 GB Recommended)
Minimum 10 GB Available Storage

Important: Shared hosting, VPS, cloud servers, and dedicated servers are supported as long as the above requirements are met.

info Note on Third-Party Services

This platform integrates with services like RouteMappy, Twilio, and Razorpay/Paystack/Flutterwave which require separate accounts and may incur additional costs. See full details in Overview →

info

Important Note

Install all required SDKs, development tools, and dependencies using the recommended versions before beginning the installation process. Version mismatches may result in build or runtime issues.

Pro Tip: Use Node Version Manager (NVM) for managing Node.js versions.

view_module Project Dependencies

Project Dependencies Overview

postn consists of two main components:

language

Customer Website

React + Inertia.js frontend

admin_panel_settings

Admin Panel

Laravel + Filament backend

info

Customer Website: React 19.2.8 with Inertia.js 3.6.1, Tailwind CSS, Vite 6.0.4

Admin Panel: Laravel 13.x with Filament 5.0, PHP 8.3+

language Customer Website Dependencies

The customer website is built with React + Inertia.js and uses the following dependencies:

Package	Version	Purpose
react	^19.2.8	UI Library
react-dom	^19.2.8	React DOM rendering
@inertiajs/react	^3.6.1	Inertia.js integration for server-side routing
@vitejs/plugin-react	^6.0.4	Vite plugin for React
@dnd-kit/core	^6.3.1	Drag & drop core functionality
@dnd-kit/sortable	^10.0.0	Sortable drag & drop lists
@dnd-kit/utilities	^3.2.2	Utilities for drag & drop
lucide-react	^1.26.0	Icon library
react-easy-crop	^6.2.3	Image cropping component
react-phone-number-input	^3.4.17	Phone number input with country codes
sonner	^2.0.7	Toast notifications
swiper	^14.0.6	Touch slider/carousel component

admin_panel_settings Admin Panel (Laravel) Dependencies

The admin panel is built with Laravel and Filament, using the following PHP dependencies:

Package	Version	Purpose
Production Dependencies
php	^8.3	Server-side scripting language
laravel/framework	^13.8	Laravel PHP Framework
filament/filament	^5.0	Admin panel framework
bezhansalleh/filament-shield	^4.3	Filament security & permissions
spatie/laravel-permission	^8.3	User roles & permissions
inertiajs/inertia-laravel	^3.1	Inertia.js server-side adapter
laravel/sanctum	^4.3	API authentication
laravel/tinker	^3.0	Artisan REPL & interactive shell
wireui/heroicons	^2.10	Heroicons for Blade/Filament
Development Dependencies
fakerphp/faker	^1.23	Fake data generation
laravel/pail	^1.2.5	Log viewer
laravel/pao	^1.0.6	Package auto-discovery optimizer
laravel/pint	^1.27	PHP code style fixer
mockery/mockery	^1.6	Mocking framework for tests
nunomaduro/collision	^8.6	Error handling for console
phpunit/phpunit	^12.5.12	PHP testing framework

Dependency Summary

language Customer Website:

Total Dependencies: 12 packages
React Version: 19.2.8
Inertia.js: 3.6.1
Drag & Drop: dnd-kit
UI Features: Image Cropping, Phone Input, Toast, Swiper

admin_panel_settings Admin Panel:

PHP Version: 8.3+
Laravel: 13.8
Filament: 5.0
Inertia.js: 3.1
Roles & Permissions: Spatie 8.3

check_circle Shared Libraries language Customer Website admin_panel_settings Admin Panel

person Customer Website Guide

How Customers Use the Platform

1

Authentication

Customer Registration: Sign up with full name, email, and mobile number
Customer Login: Login using registered mobile number and password
Forgot Password: Reset password via OTP sent to registered mobile
Reset Password: Create new password after verification
Logout: Securely logout from the application
Remember Me: Stay logged in across sessions
Show/Hide Password: Toggle password visibility

2

Home Page & Navigation

Search Bar: Instant search with autocomplete and suggestions
Categories: Dynamic categories displayed from admin management
Featured Listings: Highlighted premium listings on homepage
Latest Listings: Recently posted items from all categories
Popular Categories: Most viewed or used categories
Footer: Quick links, social media, and contact information

3

Browse & Search Listings

Grid/List View: Toggle between grid and list display modes
Advanced Filters: Filter by category, subcategory, price, condition, brand, location, and posted date
Sorting Options: Sort by latest, oldest, price low-high, and price high-low
Instant Search: Real-time search with autocomplete suggestions
Saved Searches: Save search criteria for quick access
Search Alerts: Get notifications when new listings match your search
Image Search: Search using images (if enabled)

4

Listing Details

Listing Information: View complete listing details including title, description, price, and images
Image Gallery: Browse multiple images with cover image as primary
Dynamic Specifications: Category-specific attributes (Cars: Brand, Model, Year, Fuel Type; Property: BHK, Area, Furnished)
Seller Information: View seller name, phone, email, and profile photo
Contact Options: Call seller, send email, or negotiate price
Wishlist: Save listings to personal wishlist
Report Listing: Flag inappropriate content

5

Post an Ad

Select Category: Choose appropriate category and subcategory
Dynamic Form: Category-specific form fields automatically generated
Upload Images: Upload up to 10 images (first image becomes cover)
Listing Details: Enter title, description, price, and negotiable status
Dynamic Attributes: Category-specific attributes (Cars: Brand, Model, Color, Year, Fuel Type, Mileage)
Location: Set pickup/delivery location
Contact Details: Provide contact information
Publish: Submit for moderation

6

Listing Moderation

Pending Status: Listing submitted for admin review
Approved Status: Listing approved and published on website
Rejected Status: Listing rejected with reason provided
Sold Status: Mark listing as sold
Expired Status: Auto-expired after duration
Status History: Complete audit trail of all status changes

7

Customer Dashboard

Profile Management: View and edit personal information, change password, upload profile photo
My Listings: View, edit, delete, renew, or mark as sold
Create Listing: Post new ads
Wishlist: View and manage saved listings
Saved Searches: Manage saved search queries
Notifications: View platform notifications and alerts
Booking History: View past and upcoming service bookings

8

Communication & Support

In-App Chat: Real-time messaging with sellers
Rate & Review: Rate sellers and leave feedback
Complaints: File complaints regarding listings
FAQ: Access frequently asked questions
Contact Support: Reach out to customer support
Terms & Conditions: View platform terms
Privacy Policy: View privacy policy

lightbulb Pro Tip: Save your frequently used searches and locations for faster browsing. Enable notifications to receive real-time updates on new listings!

admin_panel_settings Admin Panel Guide

Admin Panel Overview

The Admin Panel provides complete control over the classified marketplace platform. Below is the detailed menu structure and functionality for managing the platform.

Menu Section	Sub-Menu Items	Functionality
Dashboard
Dashboard	-	View business overview including total customers, total listings, pending listings, active listings, featured listings, today's listings, newsletter subscribers, and contact messages
Filament Shield
Roles	Super Admin, Admin, Moderator, Content Manager	Create and manage roles with specific permissions for access control
User Management
Customers	-	Manage customer accounts (Name, Email, Phone, Status, Profile Photo). View, edit, block, delete customers
Users	-	Manage administrator accounts with role assignments
Content
Blog Posts	-	Create and manage blog posts with categories (dynamically loaded on frontend)
About Pages	-	Manage About Us page content (dynamically loaded on frontend)
Marketplace
Categories	-	Create and manage categories with name, image, icon, and status (dynamically loaded on frontend)
Subcategories	-	Manage subcategories belonging to categories (dynamically loaded on frontend)
Attributes	Text, Number, Select, Radio, Checkbox, Date, Toggle	Create dynamic attributes for each subcategory (Cars: Brand, Model, Color, Year; Property: BHK, Area, Parking)
Listings	All, Pending, Approved, Rejected, Sold, Expired	Manage all listings with view, edit, approve, reject, feature, unfeature, delete, and bulk actions
Cities	-	Create and manage cities for popular cities section (dynamically loaded on frontend footer)
Communication
Contact Page	-	Manage Contact Us page content and company details (dynamically loaded on frontend)
Contact Messages	-	View and manage contact form submissions with reply, add note, and delete actions
Marketing
Newsletter Subscribers	-	Manage newsletter subscribers from footer subscription (dynamically collected from frontend)
Newsletter Campaigns	-	Send email campaigns to all subscribers (product updates, announcements, promotions)
Legal
Privacy Policies	-	Manage privacy policy content (dynamically loaded on frontend)
Terms Conditions	-	Manage platform terms and conditions (dynamically loaded on frontend)
FAQs	-	Manage frequently asked questions (dynamically loaded on frontend)
Settings
App Settings	-	Configure website name, logo, favicon, theme color, contact number, email, address, working hours, social links, copyright, and SEO settings (dynamically loaded on frontend)

menu Admin Menu Structure

Dashboard

Dashboard

Filament Shield

Roles

User Management

Customers
Users

Content

Blog Posts
About Pages

Marketplace

Categories
Subcategories
Attributes
Listings
Cities

Communication

Contact Page
Contact Messages

Marketing

Newsletter Subscribers
Newsletter Campaigns

Legal

Privacy Policies
Terms Conditions
FAQs

Settings

App Settings

Key Admin Workflows

Marketplace Management

Create and manage categories & subcategories
Set up dynamic attributes for each subcategory
Review and moderate listings (Approve/Reject)
Feature premium listings on homepage
Handle bulk actions for listings
Track listing status history (audit trail)
Manage cities for footer display

Customer & User Management

Manage customer accounts and profiles
View, edit, block, delete customers
Create admin roles and permissions (Filament Shield)
Manage administrator accounts and access
Role-based access control (Super Admin, Admin, Moderator, Content Manager)

Content & CMS

Manage blog posts
Update About Us page content
Manage contact page information
Reply to contact messages
Send email campaigns to newsletter subscribers

Legal & Settings

Manage Privacy Policy, Terms & Conditions, FAQs
Configure website name, logo, favicon
Manage theme colors and appearance
Update contact information and social links
Configure SEO settings

admin_panel_settings

Access URL: http://yourdomain.com/admin Default Credentials: admin@gmail.com / admin

warning

Security Note: Change default admin password immediately after first login!

admin_panel_settings Admin Panel Configuration

info

PHP Version Requirement

This admin panel requires PHP 8.3. Please ensure you have the correct version installed before proceeding.

php --version # Should show PHP 8.3.x

folder Project Structure

The complete project structure for the postn platform, including both backend (Laravel) and frontend (React + Inertia) components.


    postn/
    │
    ├── app/                              ← Backend Application
    │   ├── Console/
    │   ├── Filament/                     ← Admin Panel (20 Resources)
    │   │   ├── Pages/
    │   │   │   └── Dashboard.php
    │   │   └── Resources/
    │   │       ├── AboutPages/
    │   │       ├── AppSettings/
    │   │       ├── Attributes/
    │   │       ├── BlogPosts/
    │   │       ├── Brands/
    │   │       ├── Categories/
    │   │       ├── Cities/
    │   │       ├── ContactMessages/
    │   │       ├── ContactPages/
    │   │       ├── Customers/
    │   │       ├── Faq/
    │   │       ├── Listings/
    │   │       ├── Models/
    │   │       ├── NewsletterCampaign/
    │   │       ├── NewsletterSubscriber/
    │   │       ├── OtpLogs/
    │   │       ├── PrivacyPolicy/
    │   │       ├── Subcategories/
    │   │       ├── TermsCondition/
    │   │       └── Users/
    │   ├── Http/
    │   │   ├── Controllers/
    │   │   │   ├── Api/                  ← REST API Controllers
    │   │   │   │   ├── Auth/             ← 6 Auth Controllers
    │   │   │   │   ├── BrandModelController.php
    │   │   │   │   ├── CategoryController.php
    │   │   │   │   ├── ContactController.php
    │   │   │   │   ├── ContactMessageController.php
    │   │   │   │   ├── CustomerAuthController.php
    │   │   │   │   ├── ListingApiController.php
    │   │   │   │   ├── PopularCityController.php
    │   │   │   │   ├── ProfileController.php
    │   │   │   │   ├── SearchController.php
    │   │   │   │   ├── SearchHistoryController.php
    │   │   │   │   ├── TrendingSearchController.php
    │   │   │   │   └── UploadController.php
    │   │   │   ├── BlogController.php
    │   │   │   ├── LegalPageController.php
    │   │   │   ├── ListingController.php
    │   │   │   ├── NewsletterController.php
    │   │   │   ├── SearchController.php
    │   │   │   └── WishlistController.php
    │   │   ├── Middleware/
    │   │   │   ├── EnsureCustomerIsAuthenticated.php
    │   │   │   └── HandleInertiaRequests.php
    │   │   └── Resources/                ← 12 API Resource Transformers
    │   ├── Jobs/
    │   │   └── SendNewsletterCampaignJob.php
    │   ├── Mail/                         ← 4 Mailable Classes
    │   ├── Models/                       ← 31 Eloquent Models
    │   ├── Policies/                     ← 19 Authorization Policies
    │   ├── Providers/
    │   │   └── Filament/
    │   │       └── AdminPanelProvider.php
    │   └── Services/
    │       ├── NewsletterService.php
    │       └── SearchService.php
    │
    ├── bootstrap/
    │
    ├── config/                           ← 15 Configuration Files
    │   ├── auth.php                      ← Dual Guard System
    │   ├── filament.php
    │   ├── filament-shield.php
    │   ├── permission.php
    │   ├── sanctum.php
    │   ├── inertia.php
    │   └── ...
    │
    ├── database/
    │   ├── migrations/                   ← 75 Migrations
    │   ├── seeders/                      ← 14 Seeders
    │   └── SQL/                          ← Database Dumps
    │
    ├── public/
    │
    ├── resources/                        ← Frontend Application
    │   ├── css/
    │   │   └── app.css                   ← Tailwind v4 + Brand Theme + Animations (272 lines)
    │   └── js/
    │       ├── app.jsx                   ← Inertia Entry Point
    │       ├── Components/
    │       │   ├── Header.jsx            ← Sticky nav + category ribbon
    │       │   ├── Footer.jsx            ← Footer + newsletter form
    │       │   ├── HeroSearch.jsx        ← Homepage hero search
    │       │   ├── SearchBar.jsx         ← Autocomplete search
    │       │   ├── SearchBarInline.jsx
    │       │   ├── SearchFilters.jsx     ← Filter sidebar
    │       │   ├── CategoryCard.jsx
    │       │   ├── ListingCard.jsx       ← Listing card + wishlist toggle
    │       │   ├── ConfirmModal.jsx
    │       │   ├── DataTable.jsx
    │       │   ├── DynamicFieldRenderer.jsx ← Dynamic form fields
    │       │   ├── StatsCard.jsx
    │       │   └── ui/                   ← (empty — shadcn/ui not yet added)
    │       ├── Layouts/
    │       │   ├── MainLayout.jsx        ← Header + content + Footer
    │       │   └── MyAccountLayout.jsx   ← Sidebar + content
    │       ├── Pages/                    ← 31 Page Components
    │       │   ├── Home.jsx
    │       │   ├── Welcome.jsx
    │       │   ├── Categories.jsx
    │       │   ├── Category.jsx
    │       │   ├── Listings.jsx
    │       │   ├── ListingDetail.jsx
    │       │   ├── ListingDetails.jsx
    │       │   ├── CreateListing.jsx     ← Multi-step wizard
    │       │   ├── EditListing.jsx
    │       │   ├── SearchResults.jsx
    │       │   ├── MapSearch.jsx
    │       │   ├── Login.jsx
    │       │   ├── Register.jsx
    │       │   ├── ForgotPassword.jsx
    │       │   ├── VerifyOtp.jsx
    │       │   ├── ResetPasswordOtp.jsx
    │       │   ├── ResetPassword.jsx
    │       │   ├── Dashboard.jsx
    │       │   ├── Wishlist.jsx
    │       │   ├── Blog.jsx
    │       │   ├── BlogDetail.jsx
    │       │   ├── About.jsx
    │       │   ├── Contact.jsx
    │       │   ├── FAQ.jsx
    │       │   ├── Pricing.jsx
    │       │   ├── Subscription.jsx
    │       │   ├── Privacy.jsx
    │       │   ├── Terms.jsx
    │       │   ├── Unsubscribe.jsx
    │       │   ├── NotFound.jsx
    │       │   └── MyAccount/
    │       │       ├── Dashboard.jsx
    │       │       ├── EditProfile.jsx
    │       │       ├── CreateListing.jsx
    │       │       ├── EditListing.jsx
    │       │       └── MyListings.jsx
    │       └── stores/
    │           └── wishlist.js           ← Event-based wishlist state
    │
    ├── routes/
    │   ├── web.php                       ← Inertia Page Routes (395 lines)
    │   ├── api.php                       ← REST API Routes (115 lines)
    │   └── console.php
    │
    ├── storage/
    ├── tests/
    ├── vendor/
    │
    ├── .env                              ← Environment Configuration
    ├── .env.example
    ├── artisan
    ├── composer.json
    ├── composer.lock
    └── README.md

Backend Summary

Filament Resources: 20
API Controllers: 12+ (including Auth)
Models: 31
Policies: 19
Migrations: 75
Seeders: 14
Config Files: 15

Frontend Summary

Pages: 31
Components: 13
Layouts: 2
Framework: Inertia.js + React
CSS: Tailwind v4
State: Event-based wishlist
Entry Point: app.jsx

info

Note: The project uses a dual guard authentication system for admin and customers. The admin panel is built with Filament v3, while the frontend uses Inertia.js with React for seamless server-side rendering.

Installation Steps

admin_panel_settings Part 1: Admin Panel (Laravel Filament)

Set up the Laravel backend and Filament admin panel

1
Unzip the Source Folder

Extract the downloaded source files to your working directory.
2
Copy to XAMPP

Copy the admin folder and paste it inside XAMPP → htdocs. Rename your project folder (e.g., postn_admin).

info
Verify XAMPP & Composer: Ensure XAMPP and Composer are already installed. If not, download them from apachefriends.org and getcomposer.org.
3
Open Command Prompt

Navigate to your project folder:

cd C:\xampp\htdocs\postn_admin
4
Install PHP Dependencies

Run the following command to install all PHP dependencies:

composer install

When finished, verify the vendor folder has been created in your project.
5
Create Database

Follow these steps in phpMyAdmin:
1. Open http://localhost/phpmyadmin in your browser
2. Click "New"
3. Enter your database name (e.g., postn_admin)
4. Click "Create"
6
Import Database

Import the SQL file located at database/postn_admin.sql using phpMyAdmin:
1. In phpMyAdmin, select your newly created database
2. Click the "Import" tab
3. Choose the postn_admin.sql file from your project
4. Click "Go"
7
Generate Application Key

Run the following command to generate a unique application key:

php artisan key:generate

info
Key Generate: This command generates a unique application key that is used for encryption and security purposes.
8
Configure .env File

If .env file is not visible, enable "show hidden files" in your system settings. Update the .env file in your project root with the following settings:
Application Settings

APP_URL=http://localhost:5173 APP_ASSET_URL=http://localhost:5173/storage APP_ENV=local APP_DEBUG=true

Database Configuration

DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=postn_admin DB_USERNAME=root DB_PASSWORD=

Twilio SMS Settings

TWILIO_SID=your_twilio_sid TWILIO_TOKEN=your_twilio_token TWILIO_FROM=your_twilio_number

Razorpay Payment Gateway

RAZORPAY_KEY=your_razorpay_key RAZORPAY_SECRET=your_razorpay_secret
Firebase Configuration

Firebase is required for push notifications, real-time database features, and other Firebase services. Before using the application, configure your own Firebase project.
Step 1: Download Firebase Service Account
1. Open the Firebase Console.
2. Select your Firebase Project.
3. Go to Project Settings → Service Accounts.
4. Click "Generate New Private Key".
5. A JSON file will be downloaded (Example: your-app-name-firebase-adminsdk.json).
Step 2: Upload the JSON File

Copy the downloaded Firebase JSON file into the following directory:

config/your-app-name.json

Step 3: Update the .env File

FIREBASE_FILE=your-app-name.json FIREBASE_DB=https://your-project.firebaseio.com FCM_SERVER_KEY=your_fcm_server_key FCM_SENDER_ID=your_fcm_sender_id

check_circle

Firebase Connected

Once the JSON file is uploaded and the .env values are updated, the application will automatically connect to your Firebase project.

shield

Security Notice

Never share your Firebase Service Account JSON file or upload it to a public Git repository. This file contains sensitive credentials with administrative access to your Firebase project.
warning
Important: Replace all placeholder values with your actual credentials before running the application.
9
Run Migrations

Run the following command to create the database tables:

php artisan migrate
10
Seed the Database

Run the following command to seed the database with default data:

php artisan db:seed --force

info
The --force flag is used to run the seeder in production environments. For local development, you can omit it.
11
Generate Shield Permissions

Run the following command to generate all Shield permissions:

php artisan shield:generate --all --option=permissions --panel=admin

After generating permissions, run this command to assign the super admin role to your admin user:

php artisan tinker --execute=" $role = DB::table('roles')->where('name','super_admin')->first(); $perms = DB::table('permissions')->pluck('id')->toArray(); $rows = array_map(fn($id) => ['permission_id'=>$id,'role_id'=>$role->id], $perms); DB::table('role_has_permissions')->insertOrIgnore($rows); DB::table('model_has_roles')->insertOrIgnore(['role_id'=>1,'model_type'=>'App\\Models\\User','model_id'=>1]); echo 'Done: Admin assigned to super_admin role'; "

info
Shield: This generates all necessary permissions and assigns the super_admin role to the admin user (ID: 1).
12
Optimize the Application

Run the following command to optimize the application for production:

php artisan optimize

web Part 2: React Website (Frontend)

Set up the React frontend website located inside the admin project

13
Configure React Environment

Create a .env file in the website folder and add the following configurations:
# API Configuration (Points to the admin backend) APP_NAME=enter_your_app_name APP_ENV=local APP_KEY= APP_DEBUG=true APP_URL=enter_your_app_url APP_LOCALE=en APP_FALLBACK_LOCALE=en APP_FAKER_LOCALE=en_US APP_MAINTENANCE_DRIVER=file # APP_MAINTENANCE_STORE=database # PHP_CLI_SERVER_WORKERS=4 BCRYPT_ROUNDS=12 LOG_CHANNEL=stack LOG_STACK=single LOG_DEPRECATIONS_CHANNEL=null LOG_LEVEL=debug # Database Configuration DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=enter_your_database_name DB_USERNAME=enter_your_database_username DB_PASSWORD=enter_your_database_password DB_SOCKET= # Session SESSION_DRIVER=file SESSION_LIFETIME=120 SESSION_ENCRYPT=false SESSION_PATH=/ SESSION_DOMAIN=null # Broadcasting BROADCAST_CONNECTION=log # Filesystem FILESYSTEM_DISK=local # Queue QUEUE_CONNECTION=database # Cache CACHE_STORE=file # CACHE_PREFIX= # Memcached MEMCACHED_HOST=127.0.0.1 # Redis REDIS_CLIENT=phpredis REDIS_HOST=127.0.0.1 REDIS_PASSWORD= REDIS_PORT=6379 # Mail Configuration MAIL_MAILER=smtp MAIL_SCHEME= MAIL_HOST=enter_your_smtp_host MAIL_PORT=587 MAIL_USERNAME=enter_your_email@example.com MAIL_PASSWORD=enter_your_email_password_or_app_password MAIL_ENCRYPTION=tls MAIL_FROM_ADDRESS=enter_your_email@example.com MAIL_FROM_NAME="${APP_NAME}" # AWS (Optional) AWS_ACCESS_KEY_ID= AWS_SECRET_ACCESS_KEY= AWS_DEFAULT_REGION=us-east-1 AWS_BUCKET= AWS_USE_PATH_STYLE_ENDPOINT=false # Frontend VITE_APP_NAME="${APP_NAME}" FRONTEND_URL=http://localhost:5173 # Sanctum SANCTUM_STATEFUL_DOMAINS=localhost,localhost:5173,localhost:8000 MODE=DEMO
warning
warning
Important:

Update all placeholder values in the .env file before running the application.

Set APP_URL to your application's domain or local URL.

Configure your Firebase credentials and upload the correct Firebase Service Account JSON file.

Configure your payment gateway credentials (Razorpay, Flutterwave, Paystack) only if you plan to use those services.

Replace the RouteMappy API URL and Map Key with your own credentials.

After making changes to the .env file, run php artisan optimize:clear followed by php artisan optimize.
14
Serve Laravel Backend

In a separate terminal, navigate to the admin project root and serve the Laravel backend:

php artisan serve

The Laravel backend runs at http://localhost:5173
15
Access the Applications
- Admin Panel: http://localhost:5173/admin
- React Website: http://localhost:5173
info
Default Login:
- Email: admin@gmail.com
- Password: admin

terminal Complete Setup Quick Reference

Run these commands in sequence to set up both admin panel and website:

admin_panel_settings Admin Panel Setup

# Navigate to admin project
    cd C:\xampp\htdocs\postn_admin

    # Install PHP dependencies
    composer install

    # Generate application key
    php artisan key:generate

    # Run migrations
    php artisan migrate

    # Seed the database
    php artisan db:seed --force

    # Generate Shield permissions
    php artisan shield:generate --all --option=permissions --panel=admin

    # Optimize the application
    php artisan optimize

    # Start Laravel server (in one terminal)
    php artisan serve

web React Website Setup

# Navigate to website folder
    # Create .env file with configurations
    # (Copy .env.example to .env and update values)

Login Credentials

Use these default credentials to log in to the admin panel:

Email:	admin@gmail.com
Password:	admin
Access Level:	Super Administrator

shield

Security Alert: Change these credentials immediately after first login.

Troubleshooting

settings Environment Configuration Issues

If the application is not working correctly, verify:

The .env file exists in the project root.
All required environment variables have been updated with your own credentials.
The APP_URL points to your application URL.
Run php artisan optimize:clear after modifying the .env file.

storage Database Connection Issues

Verify the following:

MySQL service is running.
The database exists in phpMyAdmin.
Database credentials in the .env file are correct.
Run php artisan migrate if the tables have not been created.

folder_off Image & File Upload Issues

If uploaded images or files are not displayed:

Run php artisan storage:link.
Ensure the storage directory has write permission.
Clear the application cache using php artisan optimize:clear.

notifications_active Firebase Notification Issues

If push notifications are not working:

Verify the Firebase Service Account JSON file is placed in the correct location.
Ensure the Firebase values in the .env file are correct.
Confirm that your Firebase project has Cloud Messaging enabled.

cached Configuration & Cache Issues

If recent changes are not reflected:

Run php artisan optimize:clear.
Run php artisan optimize.
Restart the Laravel server using php artisan serve.

palette Website Customization Guide

sync Dynamic Content Management

All website content is managed dynamically from the Admin Panel. Any changes made in the admin are instantly reflected on the frontend website without any code changes. This guide explains how each section of the website is controlled through the admin panel.

Home Page

home Home Page Overview

The home page displays dynamic content from various admin modules:

Home Page - Dynamic content from categories, listings, and settings

Components Displayed

Search Bar — Global search for listings
Categories — From Categories module
Featured Listings — From Listings module (Featured = Yes)
Latest Listings — From Listings module (Recent posts)
Popular Categories — From Categories module
Footer — From App Settings and Cities modules

Admin Modules Used

App Settings — Logo, colors, currency, app name
Categories — Category cards with icons
Listings — Featured and latest listings
Marketing — promotions
Cities — Popular cities in footer
Newsletter — Footer subscription form

check_circle Dynamic Updates: Adding a new category, updating a listing, or changing app settings instantly updates the home page.

Content Management

article Blog Posts

Blog posts are displayed on the website's blog page. Each post includes:

Blog Page - Posts managed from Content → Blog Posts

Post Content

Title* — A catchy headline for your post
Slug* — Used in the URL. Auto-generated from title, but editable
Short Description — 1-2 sentence summary displayed on blog listing
Content* — Full blog post content with rich text editor

Status & Publishing

Status — Draft (hidden from public) or Published
Publish Date — Defaults to now when published
Category — Blog category assignment
Featured Image — Main image for the blog post
Author Image — Author avatar image

check_circle Frontend Display: Blog posts appear on the Blog page with title, excerpt, featured image, and category. Clicking a post opens the full article.

info About Pages

The About Us page is fully dynamic and displays company information:

About Us Page - Content managed from Content → About Pages

About Information

Title* — Heading displayed at the top
Short Description — One or two sentences introducing the company
About Content — Full company story and description
Mission — Company mission statement
Vision — Company vision statement
Banner Image — Story/banner image (800x600px recommended)
Active — Toggle to show/hide the page

Statistics & Core Values

Statistics — Display key metrics (Value + Label pairs)
- Example: "500,000+" + "Users"
- Example: "50+" + "Cities"
Core Values — Company core values with:
- Lucide Icon name
- Title*
- Description

check_circle Frontend Display: About Us page displays company story, mission, vision, statistics (e.g., "500,000+ Users", "50+ Cities"), and core values with icons.

Marketplace Management

category Categories

Categories appear on the homepage and navigation menus:

Categories Page - Managed from Marketplace → Categories

Category Information

Category Name* — Display name (e.g., "Cars", "Mobiles", "Properties")
Status* — Active (visible) or Inactive (hidden)
Category Icon — Icon displayed on category cards
Category Image — Image for category display

Frontend Display

Categories appear on homepage
Categories appear in navigation menu
Categories appear on category page
Clicking a category shows subcategories
Categories displayed as cards with icons

check_circle Frontend Display: Categories appear on the homepage as clickable cards. When a category is clicked, it navigates to the categories page showing all subcategories.

subdirectory_arrow_right Subcategories

Subcategories are nested under parent categories and appear when browsing:

Subcategories Page - Managed from Marketplace → Subcategories

Subcategory Information

Parent Category* — Which category this belongs to
Subcategory Name* — Display name (e.g., "Sedan", "SUV", "Hatchback")
Slug — URL-friendly name (auto-generated)
Status* — Active or Inactive
Subcategory Icon — Icon displayed on subcategory cards

Frontend Display

Subcategories displayed on category page
Subcategories appear when browsing a category
Clicking a subcategory shows listings
Subcategories shown as clickable cards

check_circle Frontend Display: Subcategories appear when a user clicks on a category. Example: Cars → Sedan, SUV, Hatchback. Clicking a subcategory opens the listings page.

tune Attributes

Attributes create dynamic forms for each subcategory:

Attribute Information

Attribute Name* — Internal name (e.g., "brand", "model")
Slug* — URL-friendly name
Display Label* — What users see (e.g., "Brand", "Model")
Field Type* — Text, Number, Select, Radio, Checkbox, Date, Toggle
Placeholder — Input placeholder text
Help Text — Helper text below the field

Settings & Display

Required — Make field mandatory
Filterable — Allow filtering by this attribute
Searchable — Include in search
Active — Show/hide attribute
Sort Order — Display order in form
Applicable Subcategories — Which subcategories use this attribute

check_circle Frontend Display: Attributes automatically generate forms when posting an ad. Example: Cars subcategory shows Brand, Model, Color, Year, Fuel Type fields. Properties show BHK, Area, Bathrooms, Furnished fields.

list_alt Listings

All user-created listings are managed from the admin panel:

Listings Page - Managed from Marketplace → Listings

Listing Management

Tabs: All, Pending, Approved, Rejected, Sold, Expired
Listing Details: Cover Image, Title, Category, Subcategory
Seller Information: Seller name and contact
Price & Location
Status — Current listing status
Created Date

Actions Available

View listing details
Edit listing
Approve / Reject
Feature / Unfeature (premium listings)
Delete
Bulk Approve, Bulk Reject, Bulk Delete

check_circle Frontend Display: Approved listings appear on the website with grid/list view, filters, sorting, and detailed listing pages with images, price, description, specifications, and seller contact.

location_city Cities

Cities are displayed in the footer and can be managed dynamically:

Newsletter & Cities - Managed from Marketing and Marketplace → Cities

City Information

City Name — Display name of the city
State — State/region the city belongs to
Active — Toggle to show/hide city
Create New — Add new cities dynamically

Frontend Display

Cities appear in the footer section
Displayed as "Popular Cities"
Automatically updates when cities are added/removed

check_circle Frontend Display: Cities appear in the footer as "Popular Cities". Adding a new city in the admin automatically adds it to the footer.

Communication

contact_page Contact Page

All contact information is managed dynamically and displayed on the Contact Us page:

Contact Page - Managed from Communication → Contact Page

Company & Contact Information

Company Name
Email — Contact email address
Contact Number — Phone number
WhatsApp Number — WhatsApp contact
Form Submissions Email — Where form submissions are sent

Address & Social Media

Office Address — Physical address
Working Hours — Business hours
Opening/Closing Time
Social Media Links: Facebook, Instagram, Twitter (X), LinkedIn, YouTube
Active — Toggle to show/hide page

check_circle Frontend Display: Contact Us page displays company name, address, phone, email, working hours, social media links, and a contact form. All data is loaded from the admin panel.

message Contact Messages

Contact form submissions from the website are collected and managed here:

View all contact form submissions
View message details (Name, Email, Phone, Subject, Message)
Reply — Send reply email to the customer
Add Note — Internal admin notes
Delete — Remove message

check_circle Frontend Display: Users submit messages via the Contact Us form. All submissions appear here for admin review and response.

Marketing

mail Newsletter Management

It displayed in the footer and can be managed dynamically:

Newsletter & Cities - Managed from Marketing and Marketplace → Cities

Newsletter Subscribers

View all subscribed emails
Subscribers collected from footer subscription
Export subscriber list
Delete subscribers

Newsletter Campaigns

Create email campaigns
Send to all subscribers
Use cases: Product updates, Announcements, Promotions
Track campaign history

check_circle Frontend Display: Newsletter subscription box appears in the footer. Users enter their email and click subscribe. All subscribers are collected here for email campaigns.

Legal Pages

privacy_tip Privacy Policies

The Privacy Policy page content is fully dynamic:

Privacy Policy Page - Managed from Legal → Privacy Policies

Title* — Page title
Active — Toggle to show/hide page
Description* — Full privacy policy content with rich text editor

check_circle Frontend Display: Privacy Policy page displays the title and full policy content. Updates in the admin are instantly reflected on the website.

gavel Terms Conditions

Terms & Conditions Page - Managed from Legal → Terms Conditions

Title* — Page title
Active — Toggle to show/hide page
Description* — Full terms and conditions content with rich text editor

check_circle Frontend Display: Terms & Conditions page displays the title and full content. Updates in the admin are instantly reflected on the website.

help FAQs

FAQ Page - Managed from Legal → FAQs

Question* — The FAQ question
Active — Toggle to show/hide FAQ
Answer* — The FAQ answer with rich text editor

check_circle Frontend Display: FAQs appear on the FAQ page as expandable accordion items. Adding or updating FAQs in the admin instantly updates the website.

Settings

settings App Settings

All application settings are managed here and reflected across the website:

Basic App Information

App Name* — Website name (appears in header and title)
App Version
Default Country — Default country for listings
Phone Code — Default country phone code
About Us — Short description for footer

Currency & Theme

Default Currency — e.g., USD, EUR, INR
Currency Symbol — e.g., $, €, ₹
Currency Short Code
App Logo — Logo displayed in header
Favicon — Browser tab icon (32x32 or 64x64)
Theme Color — Brand primary color (e.g., #f97316)

check_circle Frontend Display: All app settings are loaded dynamically. Changing the logo, favicon, theme color, currency, or app name instantly updates the entire website.

Dynamic Content Summary

Section	Admin Module	Image Reference	Frontend Display
Home Page	All Modules	`./images/website/home.webp`	categories, featured listings, latest listings, footer
Blog	Blog Posts	`./images/website/blog.webp`	Blog page with posts, categories, and featured images
About Us	About Pages	`./images/website/aboutus.webp`	About page with story, mission, vision, stats, and core values
Categories	Categories	`./images/website/categories.webp`	Homepage categories, navigation, and category pages
Subcategories	Subcategories	`./images/website/subcategories.webp`	Category → Subcategory browsing with dynamic listings
Listings	Listings	`./images/website/listings.webp`	Browse, search, filter, and detailed listing pages
Cities	Cities	`./images/website/newsletter&cities.webp`	Popular Cities in footer
Contact	Contact Page	`./images/website/contact.webp`	Contact Us page with company info, address, hours, social links
Privacy Policy	Privacy Policies	`./images/website/privacypolicy.webp`	Privacy Policy page
Terms & Conditions	Terms Conditions	`./images/website/terms&condition.webp`	Terms & Conditions page
FAQs	FAQs	`./images/website/faq.webp`	FAQ page with accordion items
Newsletter	Newsletter Subscribers	`./images/website/newsletter&cities.webp`	Footer subscription box
Branding	App Settings	-	Logo, favicon, theme color, app name, currency

sync

Key Principle: Admin → Frontend Sync

Everything shown on the website is managed from the admin panel. When you add, edit, or delete content in the admin, it automatically reflects on the frontend. No code changes are required for content management.

Add a new category → It appears on the homepage instantly
Edit the About Us content → The About page updates immediately
Change the theme color → The entire site uses the new color
Upload a new logo → The logo updates site-wide
Approve a listing → It becomes visible to all users
Send a newsletter → All subscribers receive the email

help_outline FAQ & Troubleshoot

Frequently Asked Questions & Troubleshooting

install_desktop Installation & Setup FAQs

1. Installation Dependencies Failed (npm install or composer install)

Cause: Missing or outdated Node.js/PHP version, unstable internet connection, or running commands from the wrong directory.

Solution:

Ensure Node.js (v20+) and PHP (8.3+) are installed and updated.
Open terminal inside the project root directory.
For React website dependencies:

npm install

For Laravel backend dependencies:

composer install

If the issue persists, clear cache and reinstall:

rm -rf node_modules package-lock.json
npm install

2. Module Not Found Error (React Website)

Cause: Missing dependencies, incorrect import paths, or incomplete project extraction.

Solution:

Verify all project files are extracted correctly.
Check import paths in resources/js/ files.
Reinstall dependencies:

npm install

Clear Vite cache and rebuild:

npm run build

3. Environment Variables Not Configured

Cause: Missing or incomplete environment configuration in .env file.

Solution:

Copy .env.example to .env.
Configure all required values:

APP_URL=http://localhost:5173
DB_DATABASE=postn_db
DB_USERNAME=root
DB_PASSWORD=
MAIL_HOST=smtp.gmail.com
MAIL_USERNAME=your_email@gmail.com
MAIL_PASSWORD=your_app_password

Run php artisan optimize:clear after updating .env.
Restart the Laravel server.

storefront Marketplace FAQs

4. Customer Unable to Login

Cause: Incorrect credentials, inactive account, or account suspension.

Solution:

Verify registered email or phone number is correct.
Reset password using the Forgot Password option.
Ensure account status is "Active" in Admin Panel → Customers.
Check if customer has been blocked by admin.
Verify email service is working for OTP delivery.

5. Cannot Post a New Ad

Cause: User not logged in, missing required fields, or image upload issues.

Solution:

Ensure user is logged in before posting.
Check all required fields are filled (Title, Description, Price, Category).
Verify image upload size is within limit (max 10 images, first is cover).
Check if user has reached listing limit (if configured).
Verify user account is active.

6. Listing Not Visible on Website

Cause: Listing is pending admin approval or has been rejected.

Solution:

Login to Admin Panel.
Navigate to Marketplace → Listings.
Check the "Pending" tab.
Review the listing and approve it.
If rejected, check the rejection reason provided to the customer.
Listing statuses: Pending → Approved → Active on Website.

7. Dynamic Attributes Not Showing in Ad Form

Cause: Attributes not configured correctly for the subcategory.

Solution:

Go to Admin Panel → Marketplace → Attributes.
Verify attributes are created with correct Field Type.
Ensure attributes are assigned to the correct Subcategory.
Check if attribute is set to Active.
Verify Sort Order is set correctly.

8. Images Not Uploading or Displaying

Cause: File size exceeds server limits, unsupported file format, or storage link not created.

Solution:

Upload supported image formats (JPG, PNG, WEBP).
Reduce image size (max 10 images, each under 5MB recommended).
Run php artisan storage:link to create symbolic link.
Verify upload permissions on the server.
Check APP_URL in .env is correct for asset paths.
Verify FILESYSTEM_DISK is set to public.

admin_panel_settings Admin Panel FAQs

9. Admin Panel 500 Error

Cause: PHP version mismatch, missing dependencies, or permission issues.

Solution:

Verify PHP version is 8.3+.
Run composer install to install all dependencies.
Run php artisan key:generate.
Run php artisan migrate.
Set proper permissions for storage and bootstrap/cache.
Check Laravel logs at storage/logs/laravel.log for detailed errors.

10. Admin Panel Not Loading After Installation

Cause: Missing configuration, incorrect .env values, or database connection issues.

Solution:

Verify .env configuration is complete.
Ensure database credentials are correct.
Run php artisan optimize:clear.
Run php artisan optimize.
Restart the Laravel server: php artisan serve.
Check Laravel logs for detailed errors.

11. Cannot Approve or Reject Listings

Cause: Permission issues or Filament Shield configuration missing.

Solution:

Verify your admin role has the required permissions.
Go to Admin Panel → Filament Shield → Roles.
Check if your role has Listing Management permissions.
Run php artisan shield:generate --all --option=permissions --panel=admin.
Assign the super_admin role to your admin user if needed.

12. Categories/Subcategories Not Showing on Website

Cause: Categories are set to inactive or not properly configured.

Solution:

Go to Admin Panel → Marketplace → Categories.
Ensure category Status is set to Active.
For subcategories, check parent category is active and status is active.
Clear cache: php artisan optimize:clear.
Check frontend is calling the correct API endpoint.

communication Communication & Marketing FAQs

13. OTP Verification Not Received

Cause: SMTP mail configuration is incomplete or email service is down.

Solution:

Verify SMTP mail settings in .env:

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your_email@gmail.com
MAIL_PASSWORD=your_app_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your_email@gmail.com

For Gmail, use App Password (not regular password).
Check if emails are going to spam folder.
Verify email service is working: php artisan tinker then Mail::raw('Test', fn($m) => $m->to('test@email.com')->subject('Test'));
Check Mailtrap or SMTP service provider status.

14. Newsletter Subscription Not Working

Cause: Email service configuration or newsletter module issues.

Solution:

Verify SMTP settings are correct (see OTP troubleshooting).
Check Admin Panel → Marketing → Newsletter Subscribers for test entry.
Ensure footer newsletter form is calling the correct API endpoint.
Check if duplicate email subscriptions are blocked.
Verify database queue is running: php artisan queue:work.

15. Contact Form Messages Not Being Received

Cause: Contact form configuration or email settings issues.

Solution:

Go to Admin Panel → Communication → Contact Page.
Verify Form Submissions Email is set correctly.
Check Active status is enabled.
Test contact form submission and check Contact Messages in admin.
Verify SMTP settings are working (see OTP troubleshooting).

email Email & SMTP FAQs

16. How to Configure Gmail SMTP?

Solution:

Enable 2-Factor Authentication on your Gmail account.
Generate an App Password (Google Account → Security → App Passwords).
Update .env with the following:

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your_email@gmail.com
MAIL_PASSWORD=your_app_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your_email@gmail.com
MAIL_FROM_NAME="${APP_NAME}"

Clear config: php artisan config:clear.
Test with: php artisan tinker → Mail::raw('Test', fn($m) => $m->to('test@email.com')->subject('Test'));

17. Emails Going to Spam Folder

Cause: Email authentication issues or content flagged as spam.

Solution:

Use a proper SMTP service (Gmail, SendGrid, Mailgun, etc.).
Set up SPF, DKIM, and DMARC records for your domain.
Use MAIL_FROM_NAME that matches your brand.
Avoid spam trigger words in email content.
Consider using a professional email service for better deliverability.

18. Newsletter Campaign Not Sending

Cause: Queue worker not running or email service issues.

Solution:

Start queue worker: php artisan queue:work.
Check Admin Panel → Marketing → Newsletter Campaigns for status.
Verify there are subscribers in Newsletter Subscribers.
Check .env for QUEUE_CONNECTION=database.
Run migrations: php artisan queue:table → php artisan migrate.

storage Database & Server FAQs

19. Database Connection Issues

Cause: MySQL service not running or incorrect credentials.

Solution:

Verify MySQL service is running (XAMPP/Laragon/etc.).
Check .env database settings:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=postn_db
DB_USERNAME=root
DB_PASSWORD=

Verify database exists in phpMyAdmin.
Run php artisan migrate to create tables.
Check MySQL logs for errors.

20. Migration Failed

Cause: Existing tables or migration conflicts.

Solution:

Drop all tables: php artisan db:wipe.
Run migrations fresh: php artisan migrate.
If specific migration fails, check the error in storage/logs/laravel.log.
Import the SQL file directly via phpMyAdmin if migrations continue to fail.

support_agent Need Additional Help?

If you encounter any issues that are not covered in this documentation, please contact our support team.

Support Email:

sales@menpanitech.com

Support Hours:

Monday – Friday

Response Time: Within 24–48 Business Hours

Please include the following information when contacting support:

Purchase Code
Application Version
Server Information (PHP version, OS, etc.)
Error Screenshot (if available)
Detailed Issue Description
Steps to Reproduce

This will help us provide faster and more accurate assistance.

terminal Quick Command Reference

Laravel Commands

composer install — Install PHP dependencies
php artisan key:generate — Generate app key
php artisan migrate — Run migrations
php artisan db:seed — Seed database
php artisan optimize:clear — Clear all cache
php artisan optimize — Optimize application
php artisan serve — Start Laravel server
php artisan config:clear — Clear config cache
php artisan cache:clear — Clear application cache
php artisan route:clear — Clear route cache
php artisan view:clear — Clear view cache

React/Vite Commands

npm install — Install Node dependencies
npm run dev — Start development server
npm run build — Build for production
npm run preview — Preview production build
rm -rf node_modules — Remove dependencies (reinstall)

Database

php artisan migrate:fresh — Fresh migration
php artisan db:wipe — Drop all tables
php artisan migrate:refresh — Rollback & migrate
php artisan tinker — Interactive REPL

history Change Log

update Version History

Track all updates, improvements, and fixes for the postn classified marketplace platform.

v1.0.0 Initial Release

rocket_launch What's New

First public release of postn marketplace platform
Complete authentication system with Email OTP
Customer website with React + Vite
Admin panel with Filament
Dynamic categories, subcategories & attributes
Multi-image upload (10 images)
Advanced search with filters
Wishlist & saved searches
Featured listings
Blog, About, Contact, FAQ pages
Newsletter subscribers & campaigns
Roles & permissions (Filament Shield)

memory Tech Stack

Backend: PHP 8.3+ / Laravel 13.x
Frontend: React 19.2.8 / Vite 8.x
Database: MySQL 8.0+
CSS: Tailwind CSS 4.x
Admin: Filament 5.x / Filament Shield
Auth: Laravel Sanctum / Spatie Permission

hub Services

Email (SMTP/Gmail) — OTP, notifications
All other services included with Laravel

support_agent Contact Us

support_agent

Need Help?

If you encounter an error that is not listed above, please feel free to contact our support team for further assistance. We’re here to help.

Custom Development Services

If you need any custom work, additional features, or modifications to this application, our team is ready to help you build and scale your project efficiently.

What We Can Help With

code

Custom feature development based on your business needs

palette

UI/UX design improvements and branding customization

integration_instructions

Third-party API integrations (payment, SMS, maps, etc.)

speed

Performance optimization and scalability improvements

cloud_upload

Full project setup and deployment assistance

rocket_launch

Building large-scale applications from scratch

Hire Us

You can hire our development team for complete project development, from idea to deployment, including frontend, backend, and server setup.

call

Phone Number

+91 9150 441 443

language

Website

https://menpanitech.com/

mail

Email

sales@menpanitech.com

info

Important Note

Custom development services may involve additional cost and timeline depending on the scope and complexity of the project.

We’re happy to collaborate and bring your ideas to life

Overview

info What's Included with postn

What comes with postn

Introduction

Core Features

lock Authentication Module

storefront Marketplace Features

admin_panel_settings Admin Panel Features

White-Label Solution

Getting Started

Third-Party Services

Prerequisite Knowledge

hub Third Party Services

hub Third Party Services & Integrations

info Status Legend

info Important Notice

dns Environmental Setup

verified Version Requirements

Backend Requirements

Frontend Requirements

System Requirements

Operating System:

Minimum Hardware:

Software Requirements

Laravel Dependencies

React Dependencies

XAMPP / Local Server Installation

Composer Installation

Getting Started Requirements

Verify Your Installation

memory Technology Stack

memory Complete Technology Stack

Core Technology Versions

Hosting & Production Server Requirements

info Note on Third-Party Services

Important Note

view_module Project Dependencies

Project Dependencies Overview

Customer Website

Admin Panel

language Customer Website Dependencies

admin_panel_settings Admin Panel (Laravel) Dependencies

Dependency Summary

person Customer Website Guide

How Customers Use the Platform

Authentication

Home Page & Navigation

Browse & Search Listings

Listing Details

Post an Ad

Listing Moderation

Customer Dashboard

Communication & Support

admin_panel_settings Admin Panel Guide

Admin Panel Overview

menu Admin Menu Structure

Dashboard

Filament Shield

User Management

Content

Marketplace

Communication

Marketing

Legal

Settings

Key Admin Workflows

Marketplace Management

Customer & User Management

Content & CMS

Legal & Settings

admin_panel_settings Admin Panel Configuration

PHP Version Requirement

folder Project Structure

folder Project Structure

Backend Summary

Frontend Summary

Installation Steps

admin_panel_settings Part 1: Admin Panel (Laravel Filament)

Unzip the Source Folder

Copy to XAMPP