Discovering Events on Velora
Discovering Events on Velora
Section titled “Discovering Events on Velora”The Discover Events screen is your gateway to finding events happening around you. It features a smart search bar, category and date filters, location-aware event sorting, and infinite scroll for effortless browsing. Events are displayed as visually rich cards that you can tap to view full details.
How to Get There
Section titled “How to Get There”Home Screen > Events tab (bottom navigation)
The Events tab is the default tab when you open the Velora app.
Page Layout
Section titled “Page Layout”- Title Bar: “Discover Events” heading with a location status indicator and profile/sign-in button.
- Search Bar: Animated search field with debounced search (500ms delay).
- Filter Button: Opens a filter bottom sheet with advanced filtering options.
- Filter Chips: Active filters appear as removable chips below the search bar.
- Event Cards: Scrollable list of event cards with infinite scroll pagination.
Searching for Events
Section titled “Searching for Events”- Tap the Search bar at the top of the screen.
- Type your search query (event name, keyword, or organizer).
- Results update automatically after a brief delay (500ms debounce).
- Tap any event card to view its details.
Filtering Events
Section titled “Filtering Events”- Tap the Filter icon (funnel) next to the search bar.
- A bottom sheet opens with filter options (categories, date range, location radius, etc.).
- Select your desired filters.
- Filters are applied automatically when the sheet closes.
- Active filters appear as removable chips below the search bar.
- Tap the X on any chip to remove that specific filter.
- Tap Clear All to remove all active filters at once.
The filter button shows a badge with the count of active filters.
Location-Based Discovery
Section titled “Location-Based Discovery”The app uses your device location to sort events by proximity and show distance information.
How It Works
Section titled “How It Works”- On first launch, the app requests location permission (handled once on the Home Screen).
- When location is available, events near you appear first.
- A loading spinner in the title bar indicates location is being fetched.
- If location changes significantly (more than 1km), events automatically re-sort.
- Location is optional — you can browse events without sharing your location.
Browsing Events
Section titled “Browsing Events”Events load in pages with infinite scroll:
- Scroll down through the event cards.
- When you reach near the bottom (within 200px), more events load automatically.
- A loading indicator appears at the bottom while new events are being fetched.
- Pull to refresh by swiping down to reload the entire list with fresh data.
Event Cards
Section titled “Event Cards”Each event card shows:
- Event cover image
- Event name
- Date and time
- Location or “Online” tag
- Organizer name
- Price (if applicable)
Tap any card to open the full Event Detail page.
Page States
Section titled “Page States”Loading State
Section titled “Loading State”Shimmer placeholder cards appear while events are being fetched for the first time.
Empty State
Section titled “Empty State”“No events found” message when no events match your search or filters.
Error State
Section titled “Error State”An error message with a Retry option appears if the API call fails. If you have previously loaded events, they remain visible with an error banner at the top.
Error Snackbar
Section titled “Error Snackbar”When a refresh fails but cached events exist, a floating snackbar appears with a Retry button rather than replacing the entire screen.
Profile and Sign-In
Section titled “Profile and Sign-In”The Profile button in the top-right corner provides quick access to:
- Sign In — If you are not logged in.
- Profile Menu — If you are logged in, with access to your account settings.
What to Do Next
Section titled “What to Do Next”| Your situation | Recommended action |
|---|---|
| Found an interesting event | Tap the card to view Event Details |
| Want to save for later | Add to favorites from the event detail page |
| Looking for specific category | Use the Filter button to narrow results |
| Events seem far away | Grant location permission for distance-based sorting |
| No events in your area | Try broadening your search or removing filters |
Related Articles
Section titled “Related Articles”- Event Detail — View full event information
- Home Screen — Navigate the main app tabs
- Event Policies — Platform usage policies
- Event Agenda — View event schedules
- Attendee Dashboard — Your event activities
Troubleshooting
Section titled “Troubleshooting”Events are not loading
Section titled “Events are not loading”Check your internet connection. If events were previously loaded, cached data will be shown. Pull down to refresh and try again.
Search returns no results
Section titled “Search returns no results”Try broader search terms. Event search matches against event names and keywords. Clear any active filters that might be restricting results.
Location spinner keeps showing
Section titled “Location spinner keeps showing”The location service may be taking time. This does not block event browsing — events will load without location data. Check your device’s location settings if this persists.
Filter badge shows wrong count
Section titled “Filter badge shows wrong count”The badge reflects the number of distinct active filter types. Remove individual filters by tapping the X on each chip, or use Clear All.
Events appear in wrong order
Section titled “Events appear in wrong order”Without location permission, events are sorted by date rather than proximity. Grant location permission for distance-based ordering.