korbs/butterflyvu
1
0
Fork 0
mirror of https://ark.sudovanilla.org/Korbs/butterflyvu.git synced 2024-12-22 07:13:53 +00:00
Code Issues Activity
102 commits 2 branches 0 tags 885 KiB
Astro 31.5%
CSS 22.6%
MDX 22.2%
SCSS 20.9%
JavaScript 1.5%
Other 1.3%
Find a file
Korbs b1d980d96b
Bun has issues with SCSS, modules, and more when running in Docker. Falling back to NodeJS, on Alpine.
2024-12-21 20:37:32 -05:00
public update 2024-12-12 17:49:29 -05:00
src Improve mobile support 2024-12-21 18:25:02 -05:00
.dockerignore Fix docker 2024-12-01 00:24:26 -05:00
.gitignore Fix typo 2024-12-12 09:04:59 -05:00
astro.config.mjs Add Vue integration 2024-12-21 18:24:27 -05:00
bunfig.toml Install from SudoVanilla Registry 2024-12-11 20:42:09 -05:00
config.json Set default meta color 2024-12-12 17:49:19 -05:00
docker-compose.yml Set comments, add /public for Docker Compose file 2024-12-12 17:49:39 -05:00
Dockerfile Bun has issues with SCSS, modules, and more when running in Docker. Falling back to NodeJS, on Alpine. 2024-12-21 20:37:32 -05:00
LICENSE Add license 2024-12-11 00:55:20 -05:00
package.json Update packages, add Iconior 2024-12-21 18:24:39 -05:00
README.md update 2024-12-11 15:07:48 -05:00
TODO.md Update TODO 2024-12-12 09:05:19 -05:00
tsconfig.json Fix docker 2024-12-01 00:24:26 -05:00

README.md


ButterflyVu

ButterflyVu is a 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. If you use i18n in Astro, then NodeJS will be required. (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/

Overriding Components

Since ButterflyVu is written in Astro and the site is built during each startup in Docker, overriding the components is easy. Now for, overriding the header will be shown, it's pretty much the same basics for other components.

This also works for any other part of ButterflyVu, such as for the layouts and styles. This will be expanded on once the ButterflyVu documentations are written on it's own site, ironic that it hasn't been built yet, right?

Header

In the docker-compose.yml file, add a path to the volumes section to your custom header:

  - ./components/Header.astro:/app/src/components/global/Header.astro

The file must be an .astro file, anything else like .jsx will not work.

If you already have the custom header written and it's ready for showtime, just run the Docker image again and the new header will be built with the site.

A SudoVanilla Project