Frequently Asked Questions

Quick answers to common questions about the platform.

About This Project

What is this platform?: Beacon is a revenue analytics platform. It demonstrates integration with Stripe and HubSpot APIs to track MRR, ARR, churn, retention, and pipeline metrics for B2B SaaS companies.
Who would use this type of tool?: This platform is designed for B2B SaaS companies in the $500K-$10M ARR range—founders, sales leaders, and operations teams who need visibility into revenue metrics without complex spreadsheets.
Is this a production application?: This is a demonstration with working integrations and full functionality. The demo environment uses sample data to showcase the platform's capabilities.

What tech stack is used?: Next.js 16, React 19, TypeScript, Tailwind CSS for the frontend. tRPC, Prisma, and PostgreSQL for the backend. Stripe and HubSpot APIs for integrations.
How do the integrations work?: OAuth 2.0 for authentication with both Stripe and HubSpot. Webhooks provide real-time updates for subscription changes. API polling handles historical data backfill.
How is data security handled?: OAuth tokens are encrypted at rest using AES-256. All API calls use TLS. Multi-tenant data isolation ensures organizations only see their own data.

What metrics are tracked?: MRR, ARR, net revenue, churn rate (customer and revenue), retention cohorts, customer lifetime value (LTV), average revenue per account (ARPA), and pipeline analytics.
How does the cohort analysis work?: Customers are grouped by signup month. The platform tracks revenue and customer retention over time to visualize cohort performance.
What forecasting methods are used?: Simple linear projections based on historical growth rates. Three scenarios (conservative, moderate, aggressive) allow comparison of different growth assumptions.

How do I access the demo?: Use the demo credentials: demo@revops.app / demo1234. The demo includes sample customers, subscriptions, MRR history, and pipeline deals.
Is the demo data realistic?: Yes, the demo data represents a typical early-stage SaaS company with 15+ customers, various subscription plans, expansions, contractions, and churn events over 12 months.
Can I modify the demo data?: The integrations are locked in demo mode to preserve the experience. To test with real data, you would clone the repository and connect your own Stripe/HubSpot accounts.

How can I reach the developer?: Email: maguire.murphy@live.com. You can also find me on GitHub and LinkedIn. Links are in the footer.
Can I use this code?: This project is available under the MIT license. Feel free to explore, learn from, or adapt the code for your own projects.
Is the source code available?: Yes, the full source code is available on GitHub. See the README for setup instructions.

Can't find the answer you're looking for? We're here to help.