BreathFlow is a web application that provides guided breathing exercises to help users improve their wellbeing, reduce stress, and enhance focus.
- Six different breathing techniques for various needs
- Interactive breathing animation with visual guidance
- Information about the benefits and science of breathwork
- Responsive design for all devices
- Node.js (v14 or later)
- npm or yarn
-
Clone the repository: ``` git clone https://github.com/yourusername/breathflow.git cd breathflow ```
-
Install dependencies: ``` npm install
yarn ```
-
Build the project: ``` npm run build
yarn build ```
-
The build output will be in the
out
directory. You can deploy this to GitHub Pages. -
If you're using GitHub Actions, you can add a workflow file to automate deployment:
Create a file
.github/workflows/deploy.yml
with the following content:```yaml name: Deploy to GitHub Pages
on: push: branches: - main
jobs: build-and-deploy: runs-on: ubuntu-latest steps: - name: Checkout uses: actions/checkout@v3
- name: Setup Node.js uses: actions/setup-node@v3 with: node-version: 18 - name: Install dependencies run: npm ci - name: Build run: npm run build - name: Deploy uses: JamesIves/github-pages-deploy-action@v4 with: folder: out branch: gh-pages
```
-
Enable GitHub Pages in your repository settings:
- Go to your repository on GitHub
- Click on "Settings"
- Navigate to "Pages"
- Select the
gh-pages
branch as the source - Save the changes
-
Your site should now be live at
https://yourusername.github.io/your-repo-name/
To run the project locally:
``` npm run dev
yarn dev ```
Open http://localhost:3000 in your browser to see the result.
- Next.js
- React
- Tailwind CSS
- Framer Motion
- Lucide React Icons ```
Let's also create a GitHub Actions workflow file for automated deployment: