Babyweeks

Babyweeks is a React app designed to help users track their baby's development milestones by calculating the number of weeks since a given birthdate. It started back in 2021 using PyScript and transitioned to React in early 2025. The app is hosted on GitHub Pages.

What a user can do

• Input a birthdate to calculate the weeks since birth.
• View developmental milestones content for a baby's first year.

---

Installation and Setup

Follow these steps to set up and run the app on your local machine:

Prerequisites

• Node.js (16.x or later) and npm installed.

Clone the Repository

git clone https://github.com/ntemposd/babyweeks.git
cd babyweeks

Install Dependencies

Run the following command to install all required dependencies:

npm install

Start the Development Server

To start the app in development mode:

npm start

• Open your browser and navigate to http://localhost:3000.
• The app will reload automatically as you make changes to the source code.

---

Deployment

The app is automatically deployed to GitHub Pages from the babyweeks-react branch using GitHub Actions.

View the Live Application

Visit the deployed app at:

https://ntemposd.github.io/babyweeks

Manual Deployment

If you need to deploy manually:

1. Build the app:

   npm run build

2. Deploy to GitHub Pages:

   npm run deploy

---

File Structure

.
├── public/               # Public assets
├── src/                  # Source code
│   ├── App.js           # Main application component
│   ├── App.css          # Global styles
│   ├── assets/          # Images and JSON data
│   ├── components/      # Reusable components (if applicable)
├── .github/             # GitHub workflows
│   ├── workflows/
│       ├── deploy.yml   # Deployment configuration
├── package.json         # Project metadata and scripts

---

Technologies Used

• React: Front-end framework.
• Bootstrap: For responsive and modern styling.
• DatePicker: Custom date input component.
• GitHub Pages: Deployment platform.
• GitHub Actions: CI/CD workflow for automatic deployment.

---

Contributing

1. Fork the repository.
2. Create a new branch:

   git checkout -b feature-name

3. Make your changes and commit them:

   git commit -m "Add new feature"

4. Push to the branch:

   git push origin feature-name

5. Open a pull request.

---

License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

Troubleshooting

If you encounter issues:

• Ensure all dependencies are installed by running npm install.
• Verify that your Node.js version is compatible with the app.
• Check the browser console for error messages.
• Reach out by opening an issue in the repository.