Serenity 🌿

Serenity is a cross-platform meditation app designed to help users relax, focus, and improve mindfulness through guided meditation sessions and ambient sounds.

Built with React Native, powered by Expo, and styled using Tailwind CSS via NativeWind, Serenity provides a smooth and immersive experience on both Android and iOS platforms.

---

📱 Features

• 🧘‍♀️ Guided meditation sessions
• 🎶 Soothing ambient sounds
• 🎨 Beautiful gradients & visuals
• ⚡ Fast and responsive UI
• 🌙 Dark mode friendly
• 🔁 Seamless navigation with expo-router

---

🚀 Tech Stack

• React Native
• Expo
• TypeScript
• Tailwind CSS (NativeWind)
• React Native Reanimated
• expo-av
• expo-linear-gradient
• expo-router

---

📦 Installation

Make sure you have Node.js, npm, Expo CLI, and EAS CLI installed:

npm install -g expo-cli eas-cli

Then clone the project and install dependencies:

git clone https://github.com/yourusername/serenity-app.git
cd serenity-app
npm install

---

🧪 Running the App Locally

Start in development mode:

npm start

Or run on Android/iOS simulator:

npm run android
npm run ios

---

🔨 EAS Build (APK or iOS)

First, log in to EAS:

eas login

Then configure the build setup (if not already done):

eas build:configure

To build for Android (APK) locally:

eas build --platform android --profile preview --local

Or to build on Expo’s cloud:

eas build --platform android

📄 See EAS Build Documentation for more.

---

📁 Project Structure

meditation-app/
├── app/                 # Expo Router app folder
├── assets/              # Images, fonts, audio files
├── components/          # Reusable UI components
├── scripts/             # Dev helper scripts
├── tailwind.config.js   # Tailwind setup
├── eas.json             # EAS Build config
├── app.json             # Expo config
└── ...

---

🧼 Useful Scripts

• npm run lint – Lint your code
• npm run test – Run tests
• npm run reset-project – Clean and reset cache (custom script)

---

✅ Dependencies

See the full list in package.json, including:

• expo: ~51.0.22
• react-native: 0.74.3
• expo-av, expo-linear-gradient, expo-router, react-native-reanimated, and more.

---

🧠 License

MIT License © 2025 [Your Name]

---

🤝 Contributing

Pull requests and feedback are welcome! Let’s build a more mindful world together.

---

📸 Screenshots

(Add screenshots of the home page, meditation player, and other screens here if available.)

---

🔗 Links

• Expo Docs
• EAS Build Guide
• Tailwind for React Native (NativeWind)

---

Would you like a sample `eas.json` configuration to go with this as well?