Integrating with Freckle
Freckle is a thoughtful and beautiful web-based time tracking application built for small business. Beanstalk can integrate with your Freckle account to log in hours for specific tasks every time you commit.
How To Set Up Your Freckle Integration
In order to integrate Freckle with Beanstalk, you must first setup the integration settings within your repository. To do this, go to your Repository then Setup → Integration → Freckle. To get started with the setup, click on Activate inside the page.
After clicking Activate button you will need to enter your Freckle account URL and Auth token.
Auth token can be found by clicking settings on your Freckle account. After clicking settings you will see an Integration API tab on which you can find the Auth token.
After entering account details you need to choose the project you would like to integrate the repository with. By each commit time would be logged for tasks to the project which you selected.
Check and make sure everything is correct, and on the next page hit “Activate” in order to activate integration. You will be able to change your settings or deactivate at any time.
How to use the integration
Once you have setup integration with Beanstalk and Freckle, you can add tags to your commit comments that will post log entries into your timesheet. For example:
Fixed layout on login page, login, layout fix [f:70min]
You will get an entry which you can see on dashboard of your Freckle account, under “Your Recent Entries”. The entry would look like this:
Each part of the commit message with 1 or 2 words is used as a tag, where the parts are separated with commas. In the commit message above, “login” and “layout fix” were detected as tags, and the first part of commit message was detected as a description.
Bellow is a list of tags which you can use in your commit messages to track time in Freckle.
Example Freckle tags
- m, min, mins, minute, minutes - Sets the time in minutes (e.g. 15m)
- h, hr, hrs, hour, hours - Sets the time in hours (e.g. 1h)
- d, day, days - Sets the time in working days (e.g. 1d would be 8 hours)
- 4 - Sets the time in hours
- 4,15 4.15 4:15 - Sets the time in hours and minutes
PLEASE NOTE: Email address in your beanstalk account must match email address in your freckle account.