This repository hosts a mock landing page built with Hugo using the hugo-bootstrap-theme as a submodule. The purpose of this project is to demonstrate how to customize a modern static site for a product, applying best practices in commit messaging, version control, and public code sharing.
PlantPal is a smart indoor gardening assistant designed to help plant owners care for their houseplants. Using IoT sensors, PlantPal monitors environmental conditions (like soil moisture, light, and temperature) and provides personalized care tips. It also features a community forum for sharing advice and inspiration, making plant care accessible and enjoyable.
- Responsive & Modern Design: Fully customizable landing page based on the Bootstrap theme.
- Real-Time Monitoring: Display live sensor data for each plant.
- Personalized Care: Provide tailored care recommendations based on sensor input.
- Community Engagement: Integrated community forum for tips, challenges, and social sharing.
- Easy Onboarding: A user-friendly setup wizard to get started quickly.
-
Clone the Repository (with submodules):
git clone --recurse-submodules https://github.com/<your-username>/hugo-mock-landing-page.git cd hugo-mock-landing-page code .
-
Install Dependencies:
- Ensure Node.js is installed for theme builds.
- Install any other dependencies required by the theme (see the theme’s README for details).
-
Run the Site Locally:
hugo server
. Open your browser and visit http://localhost:1313/hugo-bootstrap-theme/ (or the port indicated in your terminal) to view the site. -
Customize:
- Edit content files (in Markdown) to update copy, images, and features.
- Modify config.toml to include your name, GitHub Pages URL, and product details.
- Remove or update extraneous example pages and posts.
-
Commit Guidelines: We follow a conventional commit style. Examples include:
- feat: Add personalized care tips section
- fix: Correct image paths in static assets
- style: Update color scheme and logo
- docs: Add installation instructions to README
- chore: Remove unused example pages
-
Deploying to GitHub Pages: After running hugo to generate the static site, use the provided publish_to_gh_pages.sh script to push the output to the gh-pages branch.
Repository Structure
- config.toml: Main site configuration.
- content/: Markdown files for pages and posts.
- static/: Assets such as images and stylesheets.
- themes/hugo-bootstrap-theme/: Git submodule for the theme.
- USER-STORIES.md: Contains the user stories for PlantPal.