Rare is a very basic task management system built upon sitecmd and Flourish. The source code isn't too pretty and not very well commented as it was a bit of a rush-job to get up and running, but hopefully over time the quality will improve. Issues and pull requests are very welcome!

Rare has Markdown Extra built-in, and allows HTML in tasks and notes, so it's probably unsafe to expose this to untrusted users (i.e. your customers).

1. If you've cloned Rare, run git submodule update --init --recursive
2. Ensure the public directory is web-accessible and that Apache has mod_rewrite enabled. If you're not using Apache, convert the rewrite rules as appropriate or see how sitecmd gets on without (it should work).
3. Go through config.php and change the rare settings at the bottom of the file, and others as necessary if sitecmd is unable to determine specific values.
4. Import rare.sql into your database and create as many users as needed.
5. It's a good idea to setup htpasswd protection for Rare, as user authentication is not yet implemented. You will need to map the htpasswd usernames to those in the users table in your database.

1. If a file named rare-upgrade-{version}.sql exists (where {version} matches the version you're upgrading to), import this into your database to upgrade any tables/columns/etc. If you have missed prior upgrades, be sure to run any previous version upgrade files in the relevant order.

Important: Rare does not (yet) support user authentication, so your installation will be world-accessible unless you lock it down. Apache htpasswd is the simplest and quickest to setup, but you're welcome to extend Rare to support additional (more complex) authentication methods.

Priorities and statuses need to be added directly to MySQL, as I'm too lazy to create an admin area for those at the moment. It is preferable to set is_disabled = 1 rather than physically deleting a priority or status from the database. Disabling will prevent them showing up in drop-downs, but will preserve their place on existing tasks, which is a good thing. The same goes for user accounts - it's always good to preserve historical data, so set is_disabled for a user's account and disable their htpasswd details if they leave, or whatever. Doing this will ensure their tasks and notes will still remain linked to their old account.

Performance seems to be good at this early stage of development - Rare is handling around 1000 tasks and 2000 notes in a production environment, and search is lightning fast (and actually quite accurate).

Rare is designed to be basic - it's for people who don't want to deal with a multitude of meta-data such as due dates, progress percentages and so on. Rare is also in the very early stages of development, so has a limited number of features at present.

• Email notifications
• Task assignment (to individual users)
• Customisable priorities and statuses, with colours
• Markdown Extra built-in
• Javascript task list ordering
• Edit and delete notes and tasks
• Internal task references (#123 links to /task/123/)
• Basic search