README.md 2.4 KB
Newer Older
Ricardo J. Mendez's avatar
Ricardo J. Mendez committed
1 2 3 4 5 6 7 8
# Relevance

Relevance is a smart tab organizer for Chrome, written in ClojureScript.   

It’ll create a natural arrangement where the tabs you have spent the longest on, which are expected to be the most relevant, are placed first, and the ones you haven’t read at all are shunted to the end of your list.

[You can read more about it here](https://numergent.com/relevance/).

Ricardo J. Mendez's avatar
Ricardo J. Mendez committed
9
This is Relevance 1.0.8-SNAPSHOT.
Ricardo J. Mendez's avatar
Ricardo J. Mendez committed
10 11 12 13 14 15 16 17 18 19 20

# Building

## Development

To get a development build, run

```
lein chromebuild auto
```

21
You'll find the result in `target/unpacked/`, which you'll need to install into Chrome using developer mode.
Ricardo J. Mendez's avatar
Ricardo J. Mendez committed
22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43

## Release

To get the release version, run

```
lein clean
lein with-profile release chromebuild zip
```


# Testing

Relevance uses `doo` for running ClojureScript tests. I normally use `phantomjs`, but you can use it with the [environment of your choice](https://github.com/bensu/doo#setting-up-environments).

We can't test the entire application externally, since a lot of its API depend on Chrome functions being present (which only happens when you're running as a Chrome extension).  You can however test the general functions running:

```
lein with-profile test doo phantom
```


Ricardo J. Mendez's avatar
Ricardo J. Mendez committed
44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
# Development

## Continuous integration

I'm testing out both [Gitlab CI](https://gitlab.com/ricardojmendez/relevance/pipelines) and [Travis](https://travis-ci.org/ricardojmendez/relevance) in parallel.  I've had some issues with Travis builds failing to get dependencies, so I may deprecate it.

Consider [Gitlab CI](https://gitlab.com/ricardojmendez/relevance/pipelines) to be the authoritative source.

## Process

I'm using [git-flow](http://nvie.com/posts/a-successful-git-branching-model/). Pull requests are welcome. Please base them off the `development` branch.

## Version number conventions

Relevance uses [break versioning](https://github.com/ptaoussanis/encore/blob/master/BREAK-VERSIONING.md).

The development version on `project.clj` will reflect the current state of the code, and will normally include SNAPSHOT.

I can't update the package version from `manifest.json` to include alphanumerics, so that version will remain as the last public until I'm nearing a release (or need to test a data migration).


Ricardo J. Mendez's avatar
Ricardo J. Mendez committed
65 66
# License

Ricardo J. Mendez's avatar
Ricardo J. Mendez committed
67 68
Includes pixeden's [iOS 7 vector icons](http://themes-pixeden.com/font-demos/7-stroke/).

Ricardo J. Mendez's avatar
Ricardo J. Mendez committed
69
Relevance is (c) 2016 Numergent Limited, and released under the [MIT License](https://tldrlegal.com/license/mit-license).