Rescent is a web app designed for olfactory training and smell recovery.

Name meaning: Rescent is a wordplay combining Re (to return/recover) + Scent (aroma), representing the journey to regain your sense of smell.

• 🎯 Guided olfactory training with 4 essential scents
• ⏱️ Structured sessions: 60s stimulation + 30s sniffing
• 📱 Mobile-first design (feels like a native app)
• 🌓 Dark mode for comfortable viewing
• 🖼️ Immersive visual design with curated imagery
• ✨ Smooth view transitions between pages
• 📊 3-phase training method based on neuroplasticity

• Framework: Astro 4.x
• Styling: Tailwind CSS
• Interactivity: React (Islands)
• Transitions: Astro View Transitions
• Deploy: GitHub Pages + GitHub Actions

npm install

npm run dev

The app will be available at http://localhost:4321

npm run build
npm run preview

This app is configured for automatic deployment to GitHub Pages.

Read DEPLOY.md for step-by-step instructions.

Check DEPLOY_COMMANDS.md for copy-paste commands.

# Make script executable (first time only)
chmod +x deploy.sh

# Deploy with one command
./deploy.sh "Your commit message"

Live URL: https://joaquin021.github.io/rescent/

rescent/
├── public/
│   └── favicon.svg
├── src/
│   ├── components/
│   │   └── TrainingSession.jsx    # React component with timer logic
│   ├── data/
│   │   └── aromas.json            # Aroma database
│   ├── layouts/
│   │   └── Layout.astro           # Base layout
│   ├── pages/
│   │   ├── index.astro            # Home page with grid
│   │   └── train/
│   │       └── [id].astro         # Dynamic training page
│   └── styles/
│       └── global.css             # Global Tailwind styles
├── .github/
│   └── workflows/
│       └── deploy.yml             # GitHub Actions workflow
├── astro.config.mjs
├── tailwind.config.mjs
└── package.json

The app includes training sessions for 4 scientifically-selected scents:

• View curated images
• Read sensory adjectives
• Read evocative descriptions
• Reflect on episodic memory questions
• Do NOT smell yet - prepare your mind first

• Visual cue: "Smell Now!"
• Take short, gentle sniffs (not deep breaths)
• Focus on the sensations

• Session summary
• Options to repeat or return to menu

This app follows the olfactory training method based on neuroplasticity research:

• Frequency: 2 times per day
• Duration: Minimum 3 months
• Method: Episodic memory activation before smelling
• Breathing: Short, gentle sniffs (not deep inhalations)

Studies show that combining visual stimuli, memory recall, and consistent practice can help recover smell loss (anosmia/hyposmia) caused by various conditions.

Add Rescent to your home screen for a native app experience:

iOS (Safari):

1. Tap the share icon
2. Select "Add to Home Screen"

Android (Chrome):

1. Menu (3 dots) → "Add to Home screen"

Edit src/data/aromas.json to modify:

• Images (Unsplash URLs)
• Adjectives
• Evocative texts
• Questions

Edit src/components/TrainingSession.jsx (lines 4-7):

const PHASE_DURATIONS = {
  STIMULATION: 60,  // Change this
  ACTION: 30,       // Change this
};

Edit tailwind.config.mjs (lines 6-26) for custom color palette.

• Mobile: Vertical layout, touch-optimized
• Desktop: Split-screen immersive experience
• Breakpoints: Fully responsive from 375px to 2560px+

MIT License - Free to use and modify

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests
• Improve translations

This app was created to help people recovering from smell loss (anosmia) through structured olfactory training, combining modern web technologies with evidence-based therapeutic techniques.

Rescent = Recovering your sense of scent 🌸

Built with ❤️ using Astro, React, and Tailwind CSS