Skip to content

A local-first personal finance app

Experimental sections - Goal docs (#80)

shall0pass9df4cc18eb36
diff --git a/docs/Advanced/Experimental-Features/goal-templates.md b/docs/Advanced/Experimental-Features/goal-templates.md
new file mode 100644
index 0000000000..954aaa0d06
--- /dev/null
+++ b/docs/Advanced/Experimental-Features/goal-templates.md
@@ -0,0 +1,74 @@
+---
+title: 'Budget Goal Templates'
+---
+
+:::warning
+This is an **experimental feature**. That means we’re still working on finishing it. There may be bugs, missing functionality or incomplete documentation, and we may decide to remove the feature in a future release. If you have any feedback, please [open an issue](https://github.com/actualbudget/actual/issues) or post a message in the Discord.
+:::
+
+Create a template by adding a note to a category and adding a line that begins with `#template`.
+
+ ![](/img/goal-template-1.png)
+
+You are welcome to have other lines in your note, but the #template line must match the syntax.
+
+## How to use the templates
+
+|Syntax|Description|Application|
+|---|---|---|
+|#template $50|Budget $50 each month|Regular monthly bills, such as internet|
+|#template up to $150|Budget up to $150 each month|Variable expenses, such as petrol and groceries|
+|#template $50 up to $300|Budget $50 each month up to a maximum of $300 Funding rainy day categories, such as replacement shoes and bicycle repairs
+|#template $500 by 2022-03|Break down large, less-frequent expenses into manageable monthly expenses|Saving for a replacement car in a few years
+|#template $500 by 2021-03 repeat every 6 months|Break down large, less-frequent expenses into manageable monthly expenses|Biannual credit card fees
+|#template $500 by 2021-03 repeat every year|Break down large, less-frequent expenses into manageable monthly expenses|Annual insurance premium
+|#template $500 by 2021-03 repeat every 2 years|Break down large, less-frequent expenses into manageable monthly expenses|Domain name renewal|
+|#template $500 by 2021-12 spend from 2021-03|Budget $500 by December. Any spending between March and December is OK.|Christmas presents, overseas holiday, or any other expenses that I will be partially paying for before the target period ends.|
+|#template $500 by 2021-12 spend from 2021-03 repeat every year| |
+|#template $500 by 2021-12 spend from 2021-03 repeat every 2 years| |
+|#template $10 repeat every week starting 2022-01-03|Budget $10 a week|
+|#template $10 repeat every week starting 2022-01-03 up to 80|Budget $10 a week, up to a maximum of $80|
+|#template $10 repeat every 2 weeks starting 2022-01-04|Budget $10 fortnightly|
+|#template $10 repeat every 9 weeks starting 2022-01-04 up to 30|Budget $10 every 9 weeks, up to a maximum of $30|
+
+### Notes
+* $ sign is optional, `#template $50` and `#template 50` are the same.
+* Other currency symbols are not supported.
+* Number formats that use comma for the decimal seperator are not supported (eg, 123,45). You must use 123.45.
+* Thousands separators are not supported (eg, 1,234). You must use 1234.
+
+### Multiple Template Lines
+You can add multiple `#template` lines for a single category note. Lines that don't have a 'by' keyword in them add together, where as lines that do have the 'by' keyword are run sequentially - only the next next due template line is applied.
+
+For examples:
+
+**Budget $200/month for 3 months, then $400/month for the next 3 months**
+
+ #template $600 by 2021-03 repeat every 6 months
+
+ #template $1200 by 2021-06 repeat every 6 months
+
+
+**Streaming Services: $42.97**
+
+ Netflix
+ #template $24.99
+ Disney Plus
+ #template $9.99
+ Amazon Prime
+ #template $7.99
+
+**$120 in February 2022, $130 in March 2022**
+
+ #template $10 repeat every 2 weeks starting 2022-01-04
+ #template $100
+
+## Apply the templates
+
+To apply the goal templates you create, enable the feature in the Settings experimental section. When the feature is on, two new options will appear in the monthly budget actions list.
+
+![](/img/goal-template-2.png)
+
+**Apply budget template** will only fill empty cells using the templates.
+
+**Overwrite with budget template** will fill in all budget cells using the templates.
\ No newline at end of file
diff --git a/sidebars.js b/sidebars.js
index 97437366e1..6ef99748f1 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -274,6 +274,16 @@ const sidebars = {
'Troubleshooting/Troubleshooting-Edge',
],
},
+ {
+ type: 'category',
+ label: 'Experimental features',
+ collapsed: true,
+ items: [
+ 'Advanced/Experimental-Features/goal-templates',
+ unavailable('Report Budget'),
+ unavailable('Account syncing')
+ ],
+ },
],
},
],
diff --git a/static/img/goal-template-1.png b/static/img/goal-template-1.png
new file mode 100644
index 0000000000..98eb5f5f29
Binary files /dev/null and b/static/img/goal-template-1.png differ
diff --git a/static/img/goal-template-2.png b/static/img/goal-template-2.png
new file mode 100644
index 0000000000..173d099aef
Binary files /dev/null and b/static/img/goal-template-2.png differ