Skip to content

Conversation

@benjaminrust
Copy link

This PR addresses several critical issues found during setup:

Critical Fixes:

  • Add missing api-spec.json file for Python applications
  • Fix port configuration for AppLink service mesh compatibility
  • Update Procfile to include heroku-applink-service-mesh wrapper
  • Add VPN warning - VPNs interfere with OAuth flows
  • Require explicit app and addon parameters for reliability

Documentation Improvements:

  • Add Prerequisites section with org and network requirements
  • Restructure deployment steps in correct order
  • Add comprehensive troubleshooting section covering all common issues
  • Document CLI/browser timeout behavior as normal

Issues Resolved:

  • Port conflicts causing app crashes
  • VPN interference with Salesforce OAuth
  • Missing API specification file errors
  • Connection timeout and synchronization issues

These changes will prevent other developers from experiencing the same setup challenges.

benjaminrust added 8 commits August 27, 2025 16:34
…c.json

- Add Prerequisites section with VPN warning and org requirements
- Restructure deployment steps in correct order
- Add explicit parameter requirements for all commands
- Include comprehensive troubleshooting section
- Document critical fixes: VPN interference, port configuration, explicit parameters
- Add missing api-spec.json file for Python applications
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.

1 participant