* Add tailwind and esbuild
* Remove unused images
* Move unprocessed assets to priv directory
* Fix applyTheme script
* Remove autoprefixer
* Update bundlemon
* Remove babel config
* Revert "Remove autoprefixer"
This reverts commit fc60c31c73
.
* Make dashboard react file work
* Fix app.css imports
* Remove autoprefixer
* Add back in robots.txt
* Go back to css/ and js/ folders as opposed to assets/
* Bundle embed.host.js and embed.content.js
* Add components folder to live reload paths
* Remove bundlemon
* Use mix assets task in Dockerfil
* Add assets setup to CONTRIBUTING.md
3.8 KiB
Contributing
We welcome everyone to contribute to Plausible. This document is to help you on setting up your environment, finding a task, and opening pull requests.
Development setup
The easiest way to get up and running is to install and use Docker for running both Postgres and Clickhouse.
Make sure Docker, Elixir, Erlang and Node.js are all installed on your development machine. The .tool-versions
file is available to use with asdf or similar tools.
Start the environment
- Run both
make postgres
andmake clickhouse
. - You can set up everything with
make install
, alternatively run each command separately:- Run
mix deps.get
. This will download the required Elixir dependencies. - Run
mix ecto.create
. This will create the required databases in both Postgres and Clickhouse. - Run
mix ecto.migrate
to build the database schema. - Run
mix run priv/repo/seeds.exs
to seed the database. Check the Seeds section for more. - Run
npm ci --prefix assets
to install the required client-side dependencies. - Run
npm ci --prefix tracker
to install the required tracker dependencies. - Run
mix assets.setup
to install Tailwind and Esbuild - Run
npm run deploy --prefix tracker
to generate tracker files inpriv/tracker/js
- Run
mix download_country_database
to fetch geolocation database
- Run
- Run
make server
ormix phx.server
to start the Phoenix server. - The system is now available on
localhost:8000
.
Seeds
You can optionally seed your database to automatically create an account and a site with stats:
- Run
mix run priv/repo/seeds.exs
to seed the database. - Start the server with
make server
and navigate tohttp://localhost:8000/login
. - Log in with the following e-mail and password combination:
user@plausible.test
andplausible
. - You should now have a
dummy.site
site with generated stats.
Alternatively, you can manually create a new account:
- Navigate to
http://localhost:8000/register
and fill in the form. - Fill in the rest of the forms and for the domain use
dummy.site
- Skip the JS snippet and click start collecting data.
- Run
mix send_pageview
from the terminal to generate a fake pageview event for the dummy site. - You should now be all set!
Stopping Docker containers
- Stop and remove the Postgres container with
make postgres-stop
. - Stop and remove the Clickhouse container with
make clickhouse-stop
.
Volumes are preserved. You'll find that the Postgres and Clickhouse state are retained when you bring them up again the next time: no need to re-register and so on.
Note: Since we are deleting the containers, be careful when deleting volumes with docker volume prune
. You might accidentally delete the database and would have to go through re-registration process.
Pre-commit hooks
pre-commit
requires Python to be available locally and covers Elixir, JavaScript, and CSS. Set up with pip install --user pre-commit
followed by pre-commit install
. Conversely, if the prompts are far too bothersome, remove with pre-commit uninstall
.
Finding a task
Bugs can be found in our issue tracker. Issues are usually up for grabs.
New features need to be discussed with the core team and the community first. If you're tackling a feature, please make sure it has been already discussed in the Discussions tab. We kindly ask contributors to use the discussion comment section to propose a solution before opening a pull request.
Pull requests without an associated issue or discussion may still be merged, but we will focus on changes that have already been talked through.