compa
Version:
Compa is a free (as freedom) world wide social directory decentralized and federated with an ActivityPub API.
110 lines (64 loc) • 4.13 kB
Markdown
# 
[](https://www.gnu.org/licenses/agpl-3.0)
[](https://framagit.org/compa/compa/commits/master)
[](https://framagit.org/compa/compa/commits/master)
[](https://npmjs.com/package/compa)
[](http://webchat.freenode.net/?channels=%23compa)
This is Compa [`*/kompa/`](https://framagit.org/compa/compa/wikis/FAQ#what-mean-compa). It's a free (as freedom) worldwide social directory decentralized and federated with an ActivityPub API,
this is a horizontal [community project][community], anyone can run and participate and contribute, the focus of the project is work for
a good user interface, a clean REST API and connecting the people for a better world.
Compa use ActivtyPub as principal protocol and is compatible with Pump.io, Mastodon and other free/open source social networks
## What's Compa?
You visited a bookstore, a library and you liked it so much that you would like others to know it,
then you can create the site if it does not exist and share it with your friends or family
or you are a traveler in search of new beautiful places to visit then **Compa**
will be your travel guide based on sites that people have already rehared and valued.
You can share any place like museums, natural park, libraries etc.
## Contributing
You can open issues for bugs you've found or features you think are missing. You can also submit pull requests to this repository. Here are the guidelines for code contributions
Fork -> Patch -> Push -> Pull Request
For developer please see the guidelines for [Code Contributions](https://framagit.org/compa/compa/tree/master/CONTRIBUTING.md)
Join to IRC channel **#compa** on irc.freenode.net or see: [Community][community]
## Bugs
If you find bugs, you can report them here:
https://framagit.org/compa/compa/issues
## Installation
### Prerequisites
You'll need four things to get started:
* node.js 4.x or higher
* npm 1.1.0 or higher
* The `graphicsmagick` package with the `gm` command
### Install with npm
The easiest way is to install the software globally using npm, like
so:
npm install -g compa
That should set up all the files and dependencies for you.
### Local install
If you want to set up the software in its own directory, you can clone
the git repository, so:
git clone https://framagit.org/compa/compa.git
You can then install the dependencies using `npm`:
cd compa
npm install
npm run build
## Getting Started
For a basic setup please see the [Getting Started Guide](https://framagit.org/compa/compa/tree/master/doc/GETTING_STARTED.md)
## Wiki
For more information please check out the [Wiki](https://framagit.org/compa/compa/wikis) and our
[ReadTheDocs](https://pumpio.readthedocs.io/en/latest/) documentation.
## FAQ
- What mean Compa?
- What is the idea behind this?
- Etc.
Please see [FAQ](https://framagit.org/compa/compa/wikis/FAQ) for the answers for this and others questions.
## Roadmap
This [Roadmap](https://framagit.org/compa/compa/tree/master/doc/ROADMAP.md) is only for brainstorm, but you can make a idea of the priorities of this project.
## License
[](https://www.gnu.org/licenses/agpl-3.0.html)
**Compa** is [Free Software][freesoftware]: You can use, study share and improve it at your
will. Specifically you can redistribute and/or modify it under the terms of the
**GNU AGPL 3.0 License** as published by the Free Software Foundation.
See the [COPYING][LICENSE] file for the full license text
[community]: https://framagit.org/compa/compa/wikis/Community
[LICENSE]: https://framagit.org/compa/compa/tree/master/COPYING
[freesoftware]: https://www.gnu.org/philosophy/free-sw.html