Skip to content

Adding places app tutorial #126

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

Adding places app tutorial #126

wants to merge 2 commits into from

Conversation

0ni-x4
Copy link

@0ni-x4 0ni-x4 commented May 30, 2025

Overview

This PR adds a complete tutorial for building an interactive places management application with Whop integration.

📖 Preview the tutorial online: https://klastra.mintlify.app/essentials/places

What's Included

  • Complete Places Map Tutorial: Step-by-step guide with all source code
  • 3D Globe Visualization: Mapbox integration with custom pin markers and atmosphere effects
  • Whop Platform Integration: Authentication, access control, and forum post creation
  • Advanced Features: Client-side image uploads, timeout handling, geocoding
  • Production Ready: Deployment instructions and performance optimizations

Tutorial Highlights

  • 🌍 3D Globe Map: Beautiful Mapbox globe with custom markers
  • 🔐 Role-Based Access: Admin can add places, customers can explore
  • 📍 Place Management: Add, delete, and categorize locations with geocoding
  • 💬 Forum Integration: Automatic community notifications with images
  • Optimized Performance: Client-side uploads to handle Vercel timeouts
  • 🗄️ Database: PostgreSQL with Prisma ORM schema included
  • 🎨 Modern UI: Tailwind CSS with responsive design

File Structure

The tutorial includes complete source code for:

  • Database schema and helpers
  • API routes for places and forum management
  • React components for map interaction
  • Timeout testing utilities
  • Error handling and loading states
  • Production deployment configuration

For Developers

This tutorial demonstrates advanced Whop SDK usage including:

  • Experience and user access validation
  • Forum creation and post management
  • File upload with attachment handling
  • Company-scoped API operations

The complete source code is available at: https://github.com/0ni-x4/whop-map

Copy link

changeset-bot bot commented May 30, 2025

⚠️ No Changeset found

Latest commit: 84ae344

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copy link

vercel bot commented May 30, 2025

@0ni-x4 is attempting to deploy a commit to the Whop Team on Vercel.

A member of the Team first needs to authorize it.

@sharkey11
Copy link
Contributor

@0ni-x4 sent you a whop dm

@sharkey11 sharkey11 marked this pull request as draft June 3, 2025 01:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants