image
Roshan Sah

Sparrow sms

Sparrow SMS — SMS Gateway for Nepal

Sparrow SMS — SMS Gateway for Nepal

Role
Flutter Developer
Platforms
Android, iOS
App Store Play Store Website Version
1.0.7+7

Project Overview

Sparrow SMS is a comprehensive SMS gateway application designed specifically for Nepal’s telecom ecosystem. It provides developers and businesses with an easy-to-use interface to send SMS messages through Nepal’s major telecom operators including Nepal Telecom (GSM + CDMA) and Ncell. The app serves as both a testing platform for API tokens and a complete SMS management solution with credit monitoring and documentation.

Key Features

  • Send SMS messages to any Nepali phone number
  • Real-time credit balance monitoring and consumption tracking
  • API token management and validation
  • Comprehensive documentation with code examples
  • Token purchase request system with document upload
  • Support for Nepal Telecom (GSM + CDMA) and Ncell
  • Beautiful onboarding experience with Sparrow SMS branding
  • Offline storage for API credentials and settings

My Responsibilities

  • Designed and implemented the complete SMS sending interface with form validation
  • Built credit monitoring system with real-time balance updates
  • Created comprehensive API documentation page with code examples
  • Implemented token purchase request system with file upload capabilities
  • Developed onboarding flow with Sparrow SMS company information
  • Integrated with Sparrow SMS API endpoints for sending messages and checking credits
  • Set up local storage for persisting API tokens and user preferences
  • Handled App Store & Play Store releases and versioning

Tech Stack

Category Tools / Libraries
Frontend Flutter, Dart
State Management GetStorage for local persistence
APIs HTTP package, Dio for file uploads
UI Components Google Fonts, Loading Animations, SVG support
File Handling Image Picker, File Picker, Universal IO
Documentation Code Viewer, Dart Code Viewer
Connectivity Connectivity Plus for network status
Email Mailer package for email functionality

API Integration

The app integrates with Sparrow SMS API endpoints for core functionality:

Send SMS: https://cylinder.eachut.com/sendmessage/{token}/{from}/{to}/{message}
Check Credits: https://cylinder.eachut.com/smsCount/{token}
Token Request: https://cylinder.eachut.com/purchaseTokenRequest

Sample API Response

{ “data”: { “response_code”: 200, “credits_available”: “1000”, “credits_consumed”: “150”, “last_balance_added”: “2024-01-15”, “minimum_credit”: “100” } }

Core Functionality

SMS Sending

  • Form validation for sender ID, recipient number, and message content
  • Real-time API response handling with success/error messages
  • Persistent storage of frequently used sender and recipient information
  • Loading states and user feedback during API calls

Credit Management

  • Automatic credit balance checking on app launch
  • Display of available credits, consumed credits, and minimum credit requirements
  • Token validation and automatic logout for invalid tokens
  • Historical balance tracking

Token Purchase System

  • Multi-step form for token purchase requests
  • Document upload support (Citizenship, Company Registration, PAN/VAT)
  • Email integration for request notifications
  • Form validation and error handling

Developer Information

Developers
Roshan Sah, Prasis Rijal
Company
Eachut
API Base URL
https://cylinder.eachut.com
Supported Operators
Nepal Telecom (GSM + CDMA), Ncell

Outcome / Highlights

SMS Gateway Credit Monitoring API Documentation Token Management Nepal Telecom Support File Upload
  • Provides developers with a complete SMS testing and management platform
  • Streamlines the process of purchasing and managing Sparrow SMS API tokens
  • Comprehensive documentation helps developers integrate SMS functionality quickly
  • Supports Nepal’s major telecom operators for maximum coverage
  • User-friendly interface makes SMS sending accessible to non-technical users

Get the App

Get it on Google Play    Download on the App Store

For Developers

To integrate SMS functionality in your own app using Sparrow SMS API:

  1. Purchase an API token through the app or contact Sparrow SMS
  2. Use the provided API endpoints for sending SMS and checking credits
  3. Refer to the in-app documentation for code examples and best practices
  4. Test your integration using the app’s SMS sending interface

Description

Sparrow SMS is a comprehensive Flutter-based SMS gateway application designed specifically for Nepal's telecom ecosystem. Developed by Eachut, this cross-platform mobile app enables developers and businesses to send SMS messages through Nepal's major telecom operators including Nepal Telecom (GSM + CDMA) and Ncell. The app serves as both a testing platform for API tokens and a complete SMS management solution, featuring real-time credit monitoring, comprehensive API documentation, and a streamlined token purchase system with document upload capabilities. Users can send SMS messages, track their credit balance, and access detailed integration guides. The application integrates with Sparrow SMS API endpoints for seamless message delivery and credit management, making it an essential tool for developers looking to implement SMS functionality in their applications while supporting Nepal's local telecom infrastructure.