VoidCall – Browser‑Based International Calling Platform

🚀 Project Overview

VoidCall is a web application that enables users to make international voice calls directly from their browser — no mobile app installation required. The aim is to deliver ultra‑low cost, transparent, and accessible calling from anywhere in the world. The project’s key features include:

• Browser‑based WebRTC calling to landlines and mobiles globally.
• Pay‑as‑you‑go credit system (top‑up credits) with no long‑term contract.
• Virtual numbers in 50+ countries for local presence.
• Real‑time dashboard: call history, spending analytics, credit management.
• Referral and promotional credit opportunities.
• Transparent pricing starting as low as USD $0.02 per minute.

📋 Table of Contents

1. Features
2. Technologies & Architecture
3. Installation & Setup
4. Usage
5. Contribution
6. License
7. Future Enhancements

🧩 Features

• Cheap Global Rates: Save up to ~90% on international calls compared to traditional carriers.
• First Call Free: Users get a free credit or call to trial the service.
• Virtual Numbers: Purchase local numbers in 50+ countries to appear local to your recipients.
• Real‑Time Dashboard: View call logs, analytics, credit balance, virtual number settings.
• Referral Program: Invite friends and earn free credits when they complete their first call.
• No Subscription Required: Only pay for what you use — top up credits at your own pace.
• Secure Infrastructure: Utilizes WebRTC for browser calls; data and calls are encrypted.

🛠 Technologies & Architecture

While the public site gives the UI, the backend architecture may consist of:

• Front‑end: React / Next.js (since the page is hosted on Vercel, URL suggests “Create Next App”).
• WebRTC or SIP gateway service for voice calls.
• Payment integration for credit purchases.
• Dashboard UI for analytics and account management.
• Virtual number provisioning via telecom/SIP provider.
• Hosting: Vercel (for front‑end), likely separate backend for API / VoIP.
• Database to store users, balances, call logs, referrals, virtual numbers.
• Authentication & security: user accounts, secure sessions, encrypted voice channels.

🔧 Installation & Setup

Note: Adjust based on your actual repository structure and dependencies.

Prerequisites

• Node.js (v14+ recommended)
• Yarn or npm
• API keys for your VoIP / virtual number provider
• Payment gateway credentials
• Environment variables configured (see next step)

Setup Steps

1. Clone the repository:

   git clone https://github.com/costa-developer/voidcalls.git 
   cd your‑repo  

2. Install dependencies:

   npm install  
   # or  
   yarn install  

3. Create a .env.local file (or equivalent) with environment variables, e.g.:

    NEXT_PUBLIC_SUPABASE_URL=
    NEXT_PUBLIC_SUPABASE_ANON_KEY=
   
    # Stripe
    NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
    STRIPE_SECRET_KEY=
   
    # Base URL
    NEXT_PUBLIC_BASE_URL=http://localhost:3000
   
    SUPABASE_SERVICE_ROLE_KEY=
    STRIPE_WEBHOOK_SECRET=
   
   
    TWILIO_ACCOUNT_SID=
    TWILIO_AUTH_TOKEN=a
    TWILIO_CALLER_ID=
   
    NEXT_PUBLIC_PAYSTACK_PUBLIC_KEY=
    PAYSTACK_SECRET_KEY=
   
   

4. Run the development server:

   npm run dev  
   # or  
   yarn dev  

   Navigate to http://localhost:3000 to view the app.

5. For production build & deploy:

   npm run build  
   npm run start  

   Or deploy via Vercel / your preferred platform.

🎯 Usage

1. Sign Up: Create a free account and get initial free credits.
2. Add Credits or Buy Virtual Number: Top up your balance or purchase a local number in the country you need.
3. Start Calling: Dial any mobile or landline number from the dashboard using the browser.
4. Monitor & Analyse: Use the dashboard to track your call history, spend, use analytics.
5. Referrals: Share your referral link to friends; earn credits when they make their first call.

🤝 Contribution

We welcome contributions! Whether you'd like to submit bug fixes, enhancements, or help with documentation, please follow these steps:

• Fork the repository
• Create a feature branch (git checkout -b feature/your‑feature)
• Commit changes (git commit -m "Add feature X")
• Push branch (git push origin feature/your‑feature)
• Submit a Pull Request describing your changes and the motivation
• Ensure your code follows the project style guide / linting rules

Please open issues for any bugs or feature requests.

📦 License

Specify the license used by the project (e.g., MIT License).

MIT License
© 2025 Code With costadeveloper

📌 Future Enhancements

• Add inbound SMS support for virtual numbers.
• Mobile app version (iOS / Android) for users who prefer native apps.
• Real‑time collaboration features (teams, shared dashboards).
• More granular analytics (call quality metrics, geolocation insights).
• Multi‑language support (localisation) and accessibility improvements.
• Integration with CRM / business tools for outbound calling workflows.