← setup-guides

Facebook App Testing Instructions for HiveJournal

App Information

  • App Name: HiveJournal
  • App URL: https://hivejournal.com
  • App Type: Web Application
  • Primary Function: Digital journaling platform

Facebook Integration

HiveJournal uses Facebook for:

  • Sharing journal entries to Facebook via the Facebook Share button
  • Open Graph metadata for rich link previews when shared content is posted on Facebook

Testing Instructions

Step 1: Access the Application

  1. Navigate to https://hivejournal.com in a web browser
  2. You will see the HiveJournal homepage with a hero section

Step 2: Create a Test Account

  1. Click the "Get Started Free" button (or "Sign In" if you already have an account)
  2. You will be redirected to the signup page at /auth/signup
  3. Enter a valid email address and create a password (minimum 6 characters)
  4. Click "Sign Up" to create your account
  5. If email confirmation is enabled, check your email and confirm your account
  6. You will be automatically redirected to the dashboard after signup

Note: If you need test credentials, please contact us at privacy@hivejournal.com

Step 3: Create a Journal Entry

  1. Once logged in, you will be on the dashboard at /dashboard
  2. Click the "New Entry" button (or navigate to /dashboard/entries/new)
  3. Enter a title for your journal entry (optional)
  4. Write some content in the text editor
  5. Optionally:
    • Select a mood
    • Add tags
    • Choose a notebook
    • Customize font and background
  6. Click "Save" to save the entry

Step 4: Share an Entry to Facebook

  1. Open any saved journal entry by clicking on it from the dashboard
  2. Look for the "Share" button or icon in the entry view
  3. Click the "Share" button to open the share preview modal
  4. In the share preview modal, you will see:
    • A preview of how the entry will look when shared
    • Options to customize the appearance (background, fonts, etc.)
    • Social sharing buttons including a Facebook button
  5. Click the "Facebook" share button
  6. This will open Facebook's share dialog in a new window/tab
  7. The shared URL will be automatically populated with the entry's share link
  8. You can review the Open Graph preview (title, description, image) in the Facebook share dialog
  9. Post to Facebook or close the dialog

Step 5: Verify Open Graph Metadata

  1. After creating a share link, copy the share URL (format: https://hivejournal.com/share/[shareId])
  2. Use Facebook's Sharing Debugger tool: https://developers.facebook.com/tools/debug/
  3. Paste the share URL into the debugger
  4. Click "Debug" to see:
    • Open Graph title
    • Open Graph description
    • Open Graph image (1200x630px)
    • Any warnings or errors
  5. Verify that:
    • The title displays correctly
    • The description shows entry content
    • The image displays properly (for quotes, this will be a generated image with text overlay)
    • No critical errors are present

Step 6: Test Shared Entry View

  1. Visit a shared entry URL directly: https://hivejournal.com/share/[shareId]
  2. Verify that:
    • The entry displays correctly
    • The content is readable
    • The background image (if set) displays properly
    • The HiveJournal branding is visible
    • After 5 seconds, a call-to-action overlay appears with "HiveJournal" branding and "Get Started Free" button

Step 7: Test Data Deletion (Privacy Compliance)

  1. Navigate to Settings page: /dashboard/settings
  2. Scroll to the bottom to find the "Delete Account" section
  3. Click "Delete Account" button
  4. Review the confirmation modal that explains what will be deleted
  5. Click "Yes, Delete My Account" to confirm
  6. Verify that the account is deleted and you are signed out
  7. For full instructions, see: https://hivejournal.com/privacy (Section 6.1)

What to Verify

Facebook Sharing Functionality

  • ✅ Facebook share button opens Facebook's share dialog
  • ✅ Share URL is correctly formatted and accessible
  • ✅ Open Graph metadata displays correctly in Facebook preview
  • ✅ Shared entries are publicly viewable (no login required)
  • ✅ Shared content matches what was shared

Open Graph Metadata

  • ✅ og:title - Entry title or quote author
  • ✅ og:description - Entry content or quote text
  • ✅ og:image - Background image or generated quote image (1200x630px)
  • ✅ og:url - Correct share URL
  • ✅ og:type - Set to "article"
  • ✅ og:site_name - "HiveJournal"

Privacy & Data Handling

Test Accounts (Optional)

If you would like us to provide test accounts with pre-created entries for testing, please contact us at:

Troubleshooting

If you cannot access the app:

  • Ensure JavaScript is enabled in your browser
  • Try clearing browser cache and cookies
  • Try a different browser (Chrome, Firefox, Safari, Edge)

If sharing doesn't work:

  • Ensure pop-ups are not blocked
  • Check browser console for any errors
  • Verify you are logged in to HiveJournal

If Open Graph preview doesn't show:

  • Use Facebook Sharing Debugger to refresh the cache
  • Verify the share URL is accessible without login
  • Check that the image URL is publicly accessible

Additional Resources

Notes for Reviewers

  • HiveJournal is a journaling platform where users create personal journal entries
  • Users can choose to share entries publicly via shareable links
  • When shared to Facebook, entries use Open Graph metadata for rich previews
  • All user data can be deleted via account deletion in Settings
  • The app does not require Facebook login - Facebook is only used for sharing content
FACEBOOK TESTING INSTRUCTIONS — Docs | HiveJournal