Development

Prerequisites

To successfully run the Docpress application in development mode, you'll need to install the following prerequisites:

• Bun: The JavaScript runtime and package manager used to install dependencies and run the project's scripts.

Setting Up the Development Environment

Follow these steps to set up the development environment and start working with Docpress:

1. Clone the repository Start by cloning the Docpress repository to your local machine using Git:

   git clone https://github.com/this-is-tobi/docpress.git
   cd docpress

2. Install project dependencies Use bun to install all necessary dependencies:

   bun install

3. Fetch and build the website Run the following command to fetch documentation from the specified username and build the static website:

   bun run dev -U <username>

4. Preview the website Launch a local development server to preview your website:

   bun run vp:dev

   You can access the preview by navigating to http://localhost:8080 in your web browser.

TIP

Use command bun run dev -h to print options.

Contributions

All contributions to my repositories are welcome and must be made via Github with a pull request following the rules below.

Conventions

Commits must follow the specification of Conventional Commits, it is possible to add the VSCode extension to facilitate the creation of commits.

A PR must be made with an updated branch with the main branch in rebase (and without merge) before requesting a merge, and the merge must be requested in main.

Check whether the repository has linting rules or tests to keep them clean and ensure that CI workflows pass (new features in repositories with tests should be accompanied by new tests to ensure that the new feature works properly).