Contributing
Our framework is open source, we welcome contributions from the community. If you have a module you would like to add, please open a discussion so we can discuss the best way to integrate it.
If you wish to contribute please read the following guides:
Installation
Follow these instructions to install the framework for the first time.
Prerequisites
Before you install please make sure you have Brew installed on your machine.
You should also have Docker installed and running on your machine.
Install following packages:
brew install jq
brew install mkcert
mkcert --install
npm i -g pnpm
pnpm i -g npx
pnpm i -g ts-node
Optional dependencies:
Doppler
If you want to use doppler for secrets management and sharing:
brew install dopplerhq/cli/doppler
Additional Reading: Doppler docs
Running the framework
git clone git@github.com:juicyllama/framework.git
cd framework
pnpm run install:framework
pnpm run start:docker
If you would like to contribute to our framework, you should create a folk first and clone your folked version. See Contributing.
Build a client application
The real power of our framework is seen through the rapid development of client applications.
Checkout the build a client application walkthrough to get a solid overview of our framework in action.
As our framework grows, with more applications using it, more apps added and more developers contributing, the value also increases, this network effect is the reason why we have opensourced our work.
Postman Collection
You can access our postman collection for the framework here. This is a set of pre-build endpoints you can call on your local installation.
Development User
When you first run the application locally, it will create a default account along with an account owner you can use to authenticate with. You can use this email and password to authenticate both the API and login via the frontend.
jon.doe@example.com
S7r0#gP@$s
Contributing
We really appreciate your interest in contributing to our project. Our framework is used in many commercial projects and so it's important you follow the contributing guidelines closely.
Ahrefs
The Ahrefs app is a nestjs wrapper around the Ahrefs API. It provides a consistent interface for interacting with Ahrefs within the confines of our framework.