Farm-App is a front end application for farmOS. This repository contains the codebase for the app.
- Manage livestock details including birthdate, sex, notes, and status.
- Track equipment details such as name, manufacturer, model, and serial number.
- View active and archived animals.
- Fetch paginated data from the server.
- Detailed modal view for livestock information.
To get started with Farm-App, follow these steps:
-
Clone the repository:
git clone https://github.com/Farmer-Eds-Shed/farm-app.git cd farm-app
-
Install the dependencies:
npm install
-
Start the development server:
npm start
.
A demo version is hosted on GitHub Pages:
Important! CRUD operations will be in real time so use with caution with your own data.
Not Recommended for Production farmOS Sites.
- This is very much still a work in progress so most features do not work correctly yet.
- No credentials or any other data are stored on the site.
- farmOS Tokens are stored in your browser cache.
- This is a single page site which uses client side routing - GitHub pages will 404 if you refresh the page.
We welcome contributions to Farm-App. To contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch
). - Make your changes and commit them (
git commit -m 'Add new feature'
). - Push to the branch (
git push origin feature-branch
). - Open a pull request.
Farmer-Eds-Shed/farm-app is licensed under the GNU General Public License v3.0
For questions or feedback, please contact us at farmer-eds-shed@gmail.com.