relax-terminal
A mindful breathing exercise companion for developers that brings calmness right to your terminal. Take short, guided breathing breaks without leaving your development environment.
A mindful breathing exercise companion for developers that brings calmness right to your terminal. Take short, guided breathing breaks without leaving your development environment.
- 🎨 Beautiful ASCII art welcome message
- 🌈 Color-coded breathing guidance
- 💭 Randomized mindfulness quotes
- ⏱️ 4-4-4 breathing technique (4s inhale, 4s hold, 4s exhale)
- 📍 Centered, distraction-free display
- 🔄 Continuous operation with smooth transitions
npm install -g relax-terminal
Start your breathing session with:
relax-terminal
- Enter your name when prompted
- View your personalized ASCII art welcome message
- Follow the breathing cycle:
- INHALE (Cyan) → 4 seconds
- HOLD (Yellow) → 4 seconds
- EXHALE (Magenta) → 4 seconds
To exit the application, press Ctrl + C
-
chalk
- Terminal string styling -
figlet
- ASCII art text generation -
center-align
- Text centering utilities -
readline
- User input handling
- Node.js version 14.0.0 or higher
- Terminal with color support
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature
) - Commit your changes (
git commit -m 'Add some AmazingFeature'
) - Push to the branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
1️⃣ Add Issues & Labels on GitHub – Create some beginner-friendly issues (good first issue
, help wanted
) to encourage contributions.
2️⃣ Improve Docs – Add screenshots or GIFs showing how the tool works.
3️⃣ Automate Releases – Set up a GitHub Action to auto-publish to npm on new commits.
4️⃣ Community Engagement – Share on dev forums like Dev.to, Hashnode, or Reddit.
5️⃣ Consider Future Features – Maybe customization options, more breathing exercises, or a fun ASCII animation?