Korbs/butterflyvu
Korbs/butterflyvu
1
Fork 0
Code Issues Pull requests Activity
No description
68 commits 2 branches 0 tags 886 KiB
Astro 31.5%
CSS 22.6%
MDX 22.2%
SCSS 20.9%
JavaScript 1.5%
Other 1.3%
Find a file
Korbs 45b613e3cb Add license
2024-12-11 00:55:20 -05:00
public update 2024-08-24 00:45:23 -04:00
src Adjust mobile support 2024-12-10 22:45:55 -05:00
.dockerignore Fix docker 2024-12-01 00:24:26 -05:00
.gitignore Ignore .tar files that is generated 2024-12-10 22:59:48 -05:00
astro.config.mjs Add Pagefind integration 2024-11-14 23:52:50 -05:00
config.json Setup Feelback configuration and componet 2024-12-10 22:45:19 -05:00
docker-compose.yml Use the new SudoVanilla Registry 2024-12-10 22:59:31 -05:00
Dockerfile Fix docker 2024-12-01 00:24:26 -05:00
LICENSE Add license 2024-12-11 00:55:20 -05:00
package.json Skopeo strips the entrypoint which is not suitable, switch to Buildah 2024-12-11 00:26:16 -05:00
README.md Fix old names and typos 2024-11-12 17:31:28 -05:00
TODO.md update 2024-10-24 14:50:48 -04:00
tsconfig.json Fix docker 2024-12-01 00:24:26 -05:00

README.md

⚠ This project is new and is under active development. Do not use this in production. Visual designs, logos, assets, and etc are not final. ⚠

ButterflyVu

ButterflyVu is a new documentation template built on the Astro Web Framework.

Running

bun will be used over npm in instructions.

Requirements

  • Git
  • Bun 1 2

1. SudoVanilla recommends using the Bun package manager for Astro projects.

2. If you plan to use Bun, NodeJS is not required to be installed, which is why it's not listed as a requirement. (Tested)

Clone Repository

Start by cloning the repository to somewhere on your device using the git command:

git clone https://ark.sudovanilla.org/korbs/butterflyvu/
cd ./butterflyvu/

Install Packages

Install required packages so you can run the project:

bun install

Run

Run the website with the run command:

bun start

The website should start running at http://localhost:2014.

If the website is not running and an error appears, troubleshoot the problem by reading the error and try again. If the problem persist, submit an issue.

Hosting

Requirements

It is expected for the server admin to use the Docker method, as it is recommended, so please install the Docker Engine.

  • Install Docker Engine for Windows (WSL Method)
  • Install Docker Engine for macOS (Homebrew Method)
  • Install Docker Engine for Linux

SudoVanilla does NOT recommend using the Docker Desktop application, as it is proprietary software.

Docker Compose (Recommended)

A Docker Compose file is provided that can be used without needing to clone the repository. Download the file to it's folder somewhere on your disk and run it.

services:
  butterflyvu:
    image: ark.sudovanilla.org/korbs/butterlyvu:amd64
    volumes:
      - ./config.json:/app/config.json
      - ./docs/:/app/src/content/docs/
      - ./dists/:/app/dist/

  nginx:
    image: nginx:latest
    restart: always
    ports:
      - 4242:80
    volumes:
      - ./dists/:/usr/share/nginx/html/
A SudoVanilla Project