WeBuildaa - Startup and SaaS Directory Marketplace

WeBuildaa Hunt - is a full-featured startup and product directory script built with Laravel and TailwindCSS. Create a professional marketplace where founders can list their startups, SaaS products, apps, or tools.

Features

• Beautiful Landing Page and Directory Browsing
• Startup/Product Listing Submission Form
• Admin Dashboard to Manage Listings, Categories, and Users
• User Accounts for Founders/Product Owners
• Category and Tag Filtering
• Featured Listings and Highlighted Products
• Listing Approval System (Admin Approves or Auto-Approve)
• Built-in Contact Form for Each Listing
• SEO-Friendly URL Structure
• Responsive (Mobile-First Design)
• Built with Laravel 10+ and TailwindCSS
• Email Notifications (New Listing Submitted, Listing Approved)
• Easy Search with Keywords, Categories, and Tags
• Lightweight and Fast Performance
• Simple Installation and Setup

WEBUILDAA HUNT - Changelog
Version 1.5.0 (May 1, 2025)

New Features

-Comprehensive Documentation
-Payment Systems
-Bank Transfer
-Complete bank transfer payment workflow
-Unique reference ID generation
-Payment proof upload functionality
-Admin verification interface
-Status tracking (pending, verified, rejected)
-PayPal Integration
-Seamless PayPal checkout process
-Automatic payment verification
-Transaction recording
-Payment status tracking
-Admin Payment Management
-Dashboard for viewing all payments
-Ability to approve/reject payment proofs
-User account status management

Improvements

-Dark Mode Support: Enhanced dark mode compatibility across all documentation pages
-Responsive Design: Improved responsive design for documentation pages
-Deployment Compatibility: Updated components to be compatible with Next.js 15 static generation
-Authentication Flow: Improved authentication flow with updated Clerk integration
-Error Handling: Enhanced error handling in API routes
-Code Organization: Improved code organization and component structure

Bug Fixes

-Fixed Clerk authentication import issues for Next.js 15 compatibility
-Added proper Suspense boundaries for client-side hooks like useSearchParams
-Resolved deployment issues with static site generation
-Fixed API route errors related to authentication
-Updated deprecated API methods and imports


Version 1.4.0 (April 29, 2025)
New Features

-Language Management System
-Admin Language Settings: Added new "Languages" tab in admin site settings
-Default Language Selection: Admins can now set the default site language
-Supported Languages Management: Interface to add or remove supported languages

-Translation Editor: Built-in editor for managing translation keys and values
-Multi-language Support: Added support for English, Spanish, French, German, and Chinese

Bookmarks System

-Bookmark Products: Users can now bookmark products for later reference
-Bookmarks Page: Added a dedicated page to view and manage bookmarked products
-Bookmark API: Backend API endpoints for bookmark management

Improvements

-Site Settings Interface: Reorganized admin site settings with tabbed interface
-Translation System: Implemented higher-order component for easier translation integration
-Language Switcher: Added language switcher component in the navbar

Documentation: Added comprehensive installation guide
Package Structure: Created separate packages for different user tiers (Founder, Starter)

Bug Fixes

-Fixed serialization issues with component props in client components
-Resolved type errors in SiteSettings interface
-Fixed form submission handling for language settings
-Improved error handling in translation API endpoints

Technical Updates

-Updated SiteSettings interface to include language-related fields
-Added API endpoints for fetching, updating, creating, and deleting translations
-Created translation files for all supported languages
-Implemented withTranslation HOC for component-level translations

Requirements

Requirements Technical Requirements Node.js: v18.0.0 or higher npm: v8.0.0 or higher Git: For version control (optional) Service Accounts Supabase: For database and file storage Clerk: For authentication and user management Vercel: Recommended for deployment (alternatives: Netlify, AWS)

Instructions

🛠️ Installation Guide – WEBUILDAA HUNT

📦 Step 1: Extract the Files

Unzip the WEBUILDAA HUNT package to a preferred location on your computer.

💻 Step 2: Set Up the Project

Open your terminal and navigate to the extracted directory:

<code>cd path/to/webuildaa-hunt</code>

Install the required dependencies:

<code>npm install</code>

This may take a few minutes.

🔧 Step 3: Configure the Environment

Copy the example environment file:

<code>cp .env.example .env.local</code>

Edit .env.local and fill in:

• Supabase URL and API keys
• Clerk publishable and secret keys
• Other project-specific values

🗃️ Step 4: Set Up Supabase

• Create a new project on Supabase
• Go to the SQL Editor
• Run the SQL scripts in supabase/migrations

Or run this setup script:

<code>npm run setup-database</code>

🔐 Step 5: Configure Clerk Authentication

• Create a new app in Clerk
• Enable email/social login options
• Set these redirect URLs:

Sign-in URL:     /sign-in
Sign-up URL:     /sign-up
After sign-in:   /
After sign-up:   /
  

🚀 Step 6: Start the Development Server

Run the local dev server:

<code>npm run dev</code>

Open http://localhost:3000 and register your first account.

🛡️ Step 7: Assign Admin Role

1. Go to Supabase → Authentication → Users
2. Copy your user ID
3. In SQL Editor, run:

<code>UPDATE auth.users
SET raw_app_meta_data = jsonb_set(raw_app_meta_data, '{role}', '"admin"')
WHERE id = 'your-user-id';</code>

Then access: /admin

🌐 Step 8: Deploy to Production

<code>npm run build
vercel --prod</code>

Or deploy using your preferred host.

🎨 Customization Options

• Site Settings: Customize name, logo, and theme in the admin dashboard
• Languages: Add/remove and manage translations
• Theme: Edit tailwind.config.ts
• Content: Modify text in src/translations

🧰 Need Help?

• Email: support@webuildaa.com
• Documentation: Check the /docs folder
• Community: Join our Discord for help and discussion

Thank you for choosing WEBUILDAA HUNT for your product directory! 🚀