1
0
Fork 0
mirror of https://github.com/mealie-recipes/mealie.git synced 2025-07-22 14:49:40 +02:00
mealie/dev/dev-notes.md

62 lines
3.2 KiB
Markdown
Raw Normal View History

2021-01-03 14:25:38 -09:00
# Getting A Developer Instance Started
For the best experience developing I recommend using docker. I've used both WSL2 and Ubuntu to develop mealie and have had no issues with cross compatibility with docker. 2 Scripts are available along ith docker-compose files to make development instances easier. After cloning the repo you can set the scripts in /dev/scripts/ as executable and then use VSCode tasks to execute the scripts or execute them from the CLI.
`docker-compose.dev.sh` Will spin up a development stack with hot-reloading enabled.
`docker-compose.sh` Will spin up a production version of the stack.
After the stack is running navigate to the [admin page localhost:9090/settings/site](http://localhost:9090/settings/site). On the Backups and Exports section import the backup labeled dev_sample_data_{DATE}.zip. This will give you some recipe data to work with.
Once you're up and running you should be able to make changes and see them reflected on the frontend/backend. If you're not sure what to work on you can check:
2021-01-03 19:50:16 -09:00
- The Todo's below.
2021-01-03 14:25:38 -09:00
- The [Development Road Map](https://hay-kot.github.io/mealie/2.0%20-%20roadmap/)
- The [Current Open Issues](https://github.com/hay-kot/mealie/issues)
2021-01-03 19:50:16 -09:00
Don't forget to [join the Discord](https://discord.gg/R6QDyJgbD2)!
# Todo's
2021-01-03 12:07:44 -09:00
Frontend
2021-01-08 19:57:28 -09:00
- [x] .Vue file reorganized into something that makes sense
2021-01-03 13:54:29 -09:00
- [ ] Recipe Print Page
2021-01-03 12:07:44 -09:00
- [x] Catch 400 / bad response on create from URL
2021-01-03 19:50:16 -09:00
- [ ] Recipe Editor Data Validation Client Side
2021-01-03 12:07:44 -09:00
- [x] Favicon
- [x] Rename Window
2021-01-08 19:57:28 -09:00
- [x] Add version indicator and notification for new version available
2021-01-03 13:54:29 -09:00
- [ ] Enhanced Search Functionality
- [ ] Organize Home Page my Category, ideally user selectable.
2021-01-03 12:07:44 -09:00
Backend
- [x] Add Debug folder for writing the last pulled recipe data to.
- [x] Recipe Editor Data Validation Server Side
- [ ] Normalize Recipe data on scrape
2021-01-03 19:50:16 -09:00
- [ ] Support how to Sections and how to steps
2021-01-03 12:07:44 -09:00
- [ ] Export Markdown on Auto backups
2021-01-03 13:54:29 -09:00
- [ ] Recipe request by category/tags
- [ ] Add Additional Migrations, See mealie/services/migrations/chowdown.py for examples of how to do this.
- [ ] Open Eats [See Issue #4](https://github.com/hay-kot/mealie/issues/4)
- [ ] NextCloud [See Issue #14](https://github.com/hay-kot/mealie/issues/14)
2021-01-03 12:07:44 -09:00
# Draft Changelog
2021-01-03 19:50:16 -09:00
## v0.0.2
2021-01-03 12:07:44 -09:00
2021-01-08 19:30:54 -09:00
Bug Fixes
2021-01-03 13:54:29 -09:00
- Fixed opacity issues with marked steps - [mtoohey31](https://github.com/mtoohey31)
2021-01-05 09:05:47 -09:00
- Fixed hot-reloading development environment - [grssmnn](https://github.com/grssmnn)
2021-01-08 19:57:28 -09:00
- Fixed recipe not saving without image
- Fixed parsing error on image property null
2021-01-08 19:30:54 -09:00
General Improvements
2021-01-08 19:57:28 -09:00
- Added Confirmation component to deleting recipes - [zackbcom](https://github.com/zackbcom)
- Updated Theme backend - [zackbcom](https://github.com/zackbcom)
- Added Persistent storage to vuex - [zackbcom](https://github.com/zackbcom)
- General Color/Theme Improvements
- More consistent UI
- More minimalist coloring
- Added API Key Extras to Recipe Data
- Users can now add custom json key/value pairs to all recipes via the editor for access in 3rd part applications. For example users can add a "message" field in the extras that can be accessed on API calls to play a message over google home.
2021-01-08 19:30:54 -09:00
- Improved image rendering (nearly x2 speed)
- Improved documentation + API Documentation
2021-01-08 19:57:28 -09:00
- Improved recipe parsing