Overview
Trippins provides a comprehensive browsing experience for finding the perfect accommodation. Whether you’re looking for a budget-friendly option or a luxury hotel, the platform offers multiple ways to discover and filter housing options.Accessing the Housing Catalog
The housing catalog is publicly accessible - you don’t need to be logged in to browse available accommodations.Navigate to /room
View all available accommodations in the platform
Housing Data Structure
Each housing listing contains the following information:Pagination
Infinite Scroll Loading
The housing list uses pagination to load properties efficiently:API Endpoint for Pagination
GET /v1/api/houses
Retrieve paginated list of housing properties
Page number (zero-indexed)
Number of items per page
The default page size is 6 properties, optimized for grid display with 2 columns on desktop and 1 column on mobile.
Search Functionality
Search by Tags and Stars
Users can filter accommodations using two parameters:Available Search Tags
Common property tags include:Pool
Swimming pool available
WiFi
Free wireless internet
Parking
On-site parking
Breakfast
Breakfast included
Gym
Fitness center access
Pet Friendly
Pets allowed
Search API Endpoint
GET /v1/api/query
Advanced search with tags and star filtering
Viewing Property Details
Navigation to Detail Page
Click on any property to view full details:Loading Specific Property
Property Detail API
GET /v1/api/houses/{id}
Get detailed information for a specific property
Viewing property details requires authentication. Anonymous users must log in or register to see full property information.
Property Images
Image Storage and Retrieval
Images are stored as Base64-encoded strings in the database but served via a dedicated endpoint:Image Endpoint
GET /v1/api/houses/{id}/image
Retrieve property image
Housing Management (Admin Only)
Creating New Properties
Only authenticated users withROLE_USER or ROLE_ADMIN can create new housing listings:
POST /v1/api/houses
Create a new housing property (requires JWT)
Approval Workflow
New properties require admin approval before appearing in search results:- User submits property with
acepted: false - Admin reviews the listing
- Admin sets
acepted: trueto publish - Property becomes visible to all users
Best Practices
Optimize Image Loading
Optimize Image Loading
Use lazy loading for property images to improve page load times:
Cache Search Results
Cache Search Results
Consider caching popular search queries client-side to reduce server load and improve response times.
Implement Skeleton Screens
Implement Skeleton Screens
Show loading placeholders while fetching properties to improve perceived performance:
Error Handling
Error Handling
Always handle API errors gracefully and show user-friendly messages:
UI Flow Example
Property Tags Management
Retrieving Tags for a Property
GET /v1/api/houses/{id}/tags
Get all tags associated with a property
Troubleshooting
No Properties Displayed
No Properties Displayed
- Check if properties have
acepted: true - Verify API endpoint is responding
- Check browser console for JavaScript errors
- Ensure pagination parameters are correct
Search Returns No Results
Search Returns No Results
- Verify tag names are spelled correctly (case-sensitive)
- Check if star rating is within 1-5 range
- Ensure at least one property matches criteria
- Try broadening search parameters
Images Not Loading
Images Not Loading
- Verify image endpoint URL is correct
- Check if Base64 data is properly stored
- Ensure CORS headers allow image requests
- Verify JWT token is included for authenticated endpoints
Infinite Scroll Not Working
Infinite Scroll Not Working
- Check if
hasMoreflag is properly set - Verify
isLoadingstate is managed correctly - Ensure scroll event listener is attached
- Check network tab for failed requests
Related Resources
Making Reservations
Book a property after browsing
Writing Reviews
Share your experience about properties
Authentication
Log in to access property details
User Roles
Learn about admin approval process
