Testing Notes

Local Development Issues

Ruby 4.0 Compatibility

Issue: Jekyll 3.9 (used by GitHub Pages) has compatibility issues with Ruby 4.0+ due to removal of the tainted? method in Ruby 3.2+.

Error: undefined method 'tainted?' for nil (NoMethodError)

Impact: Local bundle exec jekyll build fails on Ruby 4.0.

Workaround Options:

1. Use Ruby 3.1 or earlier for local development:

   # Using rbenv
   rbenv install 3.1.4
   rbenv local 3.1.4
   bundle install
   bundle exec jekyll serve
   

2. Use Docker for local development:

   docker run --rm \
     --volume="$PWD:/srv/jekyll" \
     --publish 4000:4000 \
     jekyll/jekyll:3.9 \
     jekyll serve
   

3. Test on GitHub Pages directly (recommended for quick verification):
   • Push to main branch
   • GitHub Actions uses Ruby 2.7/3.x which is compatible
   • Site builds successfully on GitHub Pages

GitHub Pages Build

The site will build successfully on GitHub Pages because:

• GitHub Actions uses a compatible Ruby version (2.7.x or 3.x)
• GitHub Pages gems are locked to compatible versions
• The .github/workflows/jekyll-gh-pages.yml workflow handles the build

Manual Testing Checklist

Once the site is live on GitHub Pages, verify:

Visual Testing

• Desktop rendering (1920x1080, 1440x900)
• Tablet rendering (iPad, 768x1024)
• Mobile rendering (iPhone, 375x667)
• All navigation links work
• Hero image and overlays render correctly
• Feature cards display with hover effects
• Footer displays with legal links
• Color scheme (blue gradients) applied correctly

Content Accuracy

• No crypto/blockchain hype language
• Company details correct (Medulla Labs Limited, Cyprus)
• Contact emails accurate (contact@, privacy@, legal@, etc.)
• Services page focuses on Infrastructure, Agentic AI, Analytics, Validators
• Voice is calm approachable authority
• No placeholder text remaining

Legal Compliance (CRITICAL FOR REVOLUT)

• Privacy Policy complete with GDPR rights
• Terms of Service accurate with Cyprus jurisdiction
• Cookie Policy references consent banner
• Accessibility Statement present
• Cookie consent banner appears on first visit
• Cookie consent banner has Accept/Decline buttons
• Cookie preference persists (365 days)
• Footer has all legal links
• All legal emails work (privacy@, gdpr@, legal@, accessibility@)

Functional Testing

• Contact form submits successfully (FormSubmit)
• Service interest dropdown works
• Cookie banner Accept button hides banner
• Cookie banner Decline button hides banner
• Cookie preference remembered on reload
• Internal links work (services anchors: #infrastructure, #agentic-ai, #analytics, #validator)
• External links open (GitHub, etc.)

Technical Testing

• HTTPS enabled (GitHub Pages default)
• No console errors in browser DevTools
• No 404 errors for pages or assets
• Page load time < 3 seconds
• Mobile responsive (no horizontal scroll)
• Images load correctly (logo, splash, icons)
• Fonts load correctly (Inter, Open Sans, Fira Code)
• CSS gradients and hover effects work

SEO & Accessibility

• Meta descriptions present on all pages
• Alt text on images (logo, icons)
• Heading hierarchy logical (H1 -> H2 -> H3)
• Keyboard navigation works (Tab through links/buttons)
• Focus indicators visible
• Color contrast sufficient (WCAG AA)
• Screen reader friendly (test with VoiceOver/NVDA)

Legal Pages Specific

• Privacy Policy URL: /legal/privacy/
• Terms of Service URL: /legal/terms/
• Cookie Policy URL: /legal/cookies/
• Accessibility Statement URL: /legal/accessibility/
• All legal pages have table of contents
• Legal pages are crawlable (not noindex)
• Last updated dates are correct (2026-01-27)

Test URLs (After Deployment)

• Homepage: https://medullalabs.io/
• Services: https://medullalabs.io/services/
• About: https://medullalabs.io/about/
• Team: https://medullalabs.io/team/
• Contact: https://medullalabs.io/contact/
• Privacy: https://medullalabs.io/legal/privacy/
• Terms: https://medullalabs.io/legal/terms/
• Cookies: https://medullalabs.io/legal/cookies/
• Accessibility: https://medullalabs.io/legal/accessibility/

Known Issues

Missing Assets

• Team Photo: /assets/images/team/bob.jpg is a placeholder text file, needs actual photo
• Service Icons: SVG icons created but may need design refinement

Future Improvements

• Add actual team photos
• Refine service icon designs
• Add blog section (deferred to v1.1.0)
• Add case studies (deferred to v1.1.0)
• Implement Google Analytics with consent (GA ID placeholder in cookie-consent.html)

Deployment Verification

After pushing to main:

1. Check GitHub Actions: https://github.com/medullalabs/medullalabs.github.io/actions
2. Wait for “pages build and deployment” workflow to complete (usually 1-3 minutes)
3. Visit https://medullalabs.io/
4. Run through manual testing checklist above

Support

For build issues or questions:

• GitHub Issues: https://github.com/medullalabs/medullalabs.github.io/issues
• Email: contact@medullalabs.io