Documentation website for ago library

Contribute

NPM Commands

Install Dependencies

npm i

Watch File Changes

npm run dev

Navigate to http://localhost:5173 to see your documentation if you run project locally. For containers, visit http://localhost:3000.

With Container Engine

Note

If you use 🐳 Docker instead of 🦦 Podman, just replace podman-compose with docker compose, and podman with docker in code examples below.

Build an Image

To build an image, navigate to the root of the project and run this command:

podman-compose build

Run the Container

To run a container, navigate to the root of the project and run this command:

podman-compose up -d

You can visit http://localhost:3000 to see your documentation.

Copy node_modules Locally

If you need to copy node_modules directory from the container to your local machine, run this command:

podman cp ago-docs:/app/node_modules .

Note

node_modules is excluded from using volume in compose.yml file, that's why you need to copy it manually. It's done to prevent your local modules to be copied to Linux container, since it can create incompatibility issues between operating systems if you don't use Linux.

Enter the container

To enter inside of the container, run this command:

podman-compose exec app sh

You'll be able to run NPM commands inside of the container.

Stop the container

After you are done working, run this to cleanup containers:

podman-compose down