Anonysms Web

Send anonymous SMS messages on web.

A Flask based web application for sending anonymous SMS messages, featuring real time validation, responsive design, and integration with the Twilio API.

Quick Links

• 🔭 Built with Python, Flask, HTML, and CSS for the web interface.
• 👨‍💻 Integrates Twilio API for secure SMS delivery.
• 📊 Features real-time form validation, character counters, and flash messages for user feedback.

Project Overview

Anonysmsweb is a web application designed to allow users to send anonymous SMS messages securely. Built with Flask, it offers a modern, responsive interface that works seamlessly across devices. The application includes real-time input validation, live character counting, and clear success/error notifications via flash messages. Integration with the Twilio API ensures reliable message delivery.

Installation

1. Clone the repository:

   git clone https://github.com/zuck30/anonysmsweb
   cd anonysmsweb
   

2. Set up a virtual environment (recommended):

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

4. Set up environment variables:

   • Sign up at Twilio to get an Account SID, Auth Token, and Twilio phone number.
   • Create a .env file in the project root and add your credentials:

     SECRET_KEY='a-strong-and-secret-key'
     TWILIO_ACCOUNT_SID='your-account-sid'
     TWILIO_AUTH_TOKEN='your-auth-token'
     TWILIO_PHONE_NUMBER='your-twilio-phone-number'

   • The application uses python-dotenv to load these variables for local development.

5. Run the Flask app:

   python app.py
   

Deploying to Render

This application is ready to deploy on Render.

1. Fork this repository to your GitHub account.
2. Create a new "Blueprint" on Render and connect it to your forked repository.
3. Render will automatically detect the render.yaml file and configure the service.
4. Create a secret group on Render named twilio-credentials with your Twilio keys:
   • TWILIO_ACCOUNT_SID
   • TWILIO_AUTH_TOKEN
   • TWILIO_PHONE_NUMBER
5. Deploy! Your application will be live at the URL provided by Render.

Usage

• Launch App: Run python app.py and open the provided URL in a browser (typically http://localhost:5001).
• Send Messages: Enter the recipient's phone number and message content in the web form. The interface provides real time validation and a character counter.
• View Feedback: Receive flash messages indicating success or error after sending a message.
• Mobile Responsive: Access the app on phones or tablets with a fully responsive design.

Web App Features

Feature	Description
Modern Web Interface	Clean, responsive design that works on all devices
Real time Validation	Instant feedback on form inputs (e.g., valid phone number, message length)
Character Counter	Live tracking of message length
Flash Messages	Clear success/error notifications after sending messages
Mobile Responsive	Optimized for phones, tablets, and desktops

Languages

Frameworks & Libraries

Tools

Issues

Please submit a pull request or open an issue for bug reports, feature requests, or improvements.

License

This project is licensed under the MIT License. See the LICENSE file for details.

TODO::

• Buy a twilio phone number
• Donation to keep project alive.