Skip to content
This repository was archived by the owner on Nov 16, 2025. It is now read-only.

chasingsunsets/Toadly

Repository files navigation

Happy Toad

Toadly

Background

Visit our deployed website -> https://toadly.vercel.app/

Welcome to Toadly! Our WAD2 project designed to boost productivity by combining the proven Pomodoro Technique with a cozy virtual environment. We aim to make studying and working both productive and enjoyable, helping you focus and achieve your goals in a fun and interactive way.


Core Features

1. Immersive Study Environments

  • Customisable Audio:
    Choose your ideal study ambiance by selecting from Spotify playlists or ambient sounds like brown noise and rain sound keeping you focused, relaxed, and entertained.

  • Dynamic Backgrounds:
    The interface background automatically changes to reflect the time of day and current weather conditions, making your virtual space feel alive and responsive.

2. Personalised Settings: Pomodoro & Goal Management

  • Flexible Pomodoro Timer:
    Adjust your study and break intervals to suit your workflow.

  • Goal Management:
    Organise your to-do list and visualise your tasks in a weekly calendar, making it easy to track your progress throughout the week.

  • AI-Powered Task Breakdown:
    Use AI to help break down complex tasks into manageable subtasks, so you can tackle your goals step by step.

3. Study Rooms

Create or join virtual study rooms with friends, classmates, or the public. These collaborative spaces emulate real life group study sessions to boost focus, accountability, and social interaction. Rooms support public/private modes and synchronised study sessions with structured breaks to encourage productivity and build community.

4. Analytics Dashboard

Track your productivity and study patterns with a personalised dashboard. Visual analytics help you recognise trends and identify areas for improvement.


Tech Stack

  • Frontend: Vue.js & Vite (deployed on Vercel)
  • Backend: Socket.IO server (hosted on Railway)

APIs Used

  • OpenWeatherMap
  • Spotify API
  • Freesound.org API
  • Groq AI API
  • Socket.IO
  • Supabase

Setup and Running the Application Locally

Vite

In a new terminal, run:

npm install
npm run dev

Server

In a separate terminal, run:

node server.js

Troubleshooting

If you encounter errors:

rm -rf node_modules package-lock.json pnpm-lock.yaml yarn.lock
npm cache clean --force
npm install

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages