webshell/README.md

webshell

Webová aplikace implementující terminal shell jako webové rozhraní. Aplikace je zdarma hostovaná přes Vercel a je veřejně dostupná na adrese https://webshell.binekrasik.dev/

buildování

0. Pro buildování je potřeba software třetích stran:
   • Bun -> JavaScriptový/TypeScriptový runtime. Stáhnout lze z více zdrojů. Po instalaci doporučuji přidat Bun executable do PATH. Je možno použít Node.JS a npm.
     • Univerzálně: pomocí npm příkazem npm i -g bun
     • Win NT:
       1. ze stránky https://bun.sh/
       2. přes winget powershellovým příkazem winget install --id Oven-sh.Bun
       3. pomocí chocolatey příkazem choco install bun
     • Arch Linux:
       1. ze stránky https://bun.sh/
       2. z extra repozitáře příkazem pacman -S bun
     • MacOS:
       1. ze stránky https://bun.sh/
       2. pomocí homebrew příkazem brew tap oven-sh/bun && brew install bun
   • Vite -> Builder a packer pro webové aplikace
     • Již definováno jako závislost v projektovém package.json
   • Sass -> Nástavba CSS, slouží čistě pro srozumitelnost v rozsáhlejších projektech
     • Závislost v package.json
1. Otevřete systémovou shell v projektovém adresáři (nejpravděpodobněji .../webshell/)
2. Stáhněte potřebné balíčky a jejich závislosti
   • přes Bun příkazem bun i
   • pommocí npm příkazem npm i
3. Spusťte dev server pomocí <bun/npm> run dev
4. Stránka je nyní lokálně dostupná na http://localhost:3000/
5. (volitelné) Apliakci je možné buildnout pomocí <bun/npm> run build. Statická verze stránky je nyní dostupná v adresáři webshell/dist/

licence

Tato webová aplikace včetně jejího zdrojového kódu je veřejně dostupná pod licencí Apache 2.0 (SPDX: Apache-2.0). Zdrojový kód je veřejně dostupný na https://git.martinpetr.dev/binekrasik/webshell

Copyright 2026 Vendelín Mžik

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.