Digital Stress &
Screen Time Survey

Challenge

Digital fatigue is a growing concern — but most people don't have a simple, accessible way to measure how their screen habits are affecting their stress levels.

The challenge was to build a conversational terminal tool that guides users through a short survey, captures their digital habits, and returns instant personalised recommendations — all without a web interface, using pure Python logic deployed to Heroku.

Approach

The application was built entirely in Python, using a guided CLI experience with input validation and personalised response logic. All data is stored and retrieved via the Google Sheets API.

• Designed a conversational CLI flow — step-by-step prompts with validation and error handling
• Built personalised recommendation logic based on user responses about screen time, social media and stress
• Integrated Google Sheets API via gspread for secure data storage and group comparisons
• Implemented group-level analysis — users see how their habits compare to others
• Deployed to Heroku using the Code Institute terminal template
• Designed for inclusivity — simple language, jargon-free, accessible to all reading levels

Deliverables

• Digital wellness survey — guided CLI questionnaire on screen habits and stress
• Personalised recommendations — instant feedback based on individual responses
• Group comparisons — see how habits align with other users
• Google Sheets integration — secure data storage via API
• Input validation — robust error handling throughout the flow
• Heroku deployment — live and publicly accessible terminal app

Results

A fully functional wellness tool deployed and accessible in production:

The Digital Stress Survey demonstrates pure Python development — logic design, API integration, data handling, and CLI user experience — deployed as a real-world wellness tool accessible to anyone with a browser.