Przygotowanie środowiska
Do uruchomienia Strapi v4 będzie potrzebny poniższy zestaw narzędzi:
- Node.js w wersjach LTS (v14, v16, v18). Wersje rozwojowe nie są polecane przez twórców Strapi. Dla Strapi od wersji 4.3.9 szczególnie polecana jest gałąź Node.js v18, dla wersji od 4.0.x do 4.3.8 – Node.js v16.
- npm (tylko v6) lub yarn – zależnie od tego, który bardziej Ci odpowiada
- Python – polecam początkującym w Strapi, bo do pierwszych eksperymentów wystarczy baza danych SQLite, której włączenie w Strapi wymaga właśnie Pythona. Jeżeli nie będziesz korzystać z SQLite, możesz pominąć instalację Python’a.
Utworzenie projektu Strapi
W celu utworzenia projektu Strapi należy postępować zgodnie z poniższymi instrukcjami.
- W terminalu (polecam ten w MS Visual Studio Code) uruchom poniższą komendę.
Ostatnia fraza określa nazwę katalogu, który zostanie utworzony w katalogu, w którym komenda jest uruchomiona.
Nie ma możliwości niepodania nazwy projektu. Jeżeli nie wpiszesz jej od razu, skrypt zapyta o nią w kolejnym kroku.
UWAGA! Jeżeli podczas tworzenia nowego projektu wystąpią błędy, prawdopodobnie wynikają z tego, że w nazwie któregoś katalogu w ścieżce pojawiła się spacja.
W takim przypadku, usuń to, co utworzył automat i zacznij jeszcze raz. Tym razem upewnij się, że nie ma spacji w ścieżce.
Jeżeli używasz npm wpisz:
npx create-strapi-app@latest nazwa-projektu
Natomiast dla używających yarn’a:
yarn create strapi-app nazwa-projektu- Skrypt rozpocznie kopiowanie plików i komponowanie aplikacji w wybranym miejscu.
Po chwili zostaną wyświetlone dwie opcje do wyboru:
Quickstart (recommended) – ustawia domyślną konfigurację włączając użycie SQLite
Custom (manual settings) – pozwala na wybranie ustawień takich jak użycie JavaScript lub TypeScript, czy określenie silnika i konfiguracji bazy danych.
Wybór trybu zależy oczywiście od Twojego aktualnego celu. Jeżeli chcesz od razu przejść do zabawy z panelami CMS-a najszybciej będzie wybrać Quickstart.
Po kilku chwilach instalacji modułów, Strapi automatycznie uruchomi stronę panela w przeglądarce.
- Wpisz swoje dane, którymi będziesz się logować do panela Strapi. Opcjonalnie zaznacz na dole checkbox. Wtedy na podany adres e-mail będą przychodziły informacje o nowościach i zmianach wysyłane przez producenta Strapi.
Mając działającą instancję Strapi v4 na swoim komputerze możesz przejść do kolejnych etapów zabawy.