Development
Getting Started​
The basics are the same as in the Quick Start section, but we'll need to download more dependencies.
Prerequisites​
Steps​
1. Clone the repository​
git clone https://github.com/goniszewski/grimoire
2. Rename the .env.example file to .env​
mv .env.example .env # on Linux/MacOS
# or
ren .env.example .env # on Windows
The default .env file will look like this:
.env
# Set this to your domain name (default: http://localhost:5173)
# Example: PUBLIC_ORIGIN=grimoire.mydomain.com
PUBLIC_ORIGIN=http://localhost:5173
# Set this to true if you're using HTTPS (default: false)
# Example: PUBLIC_HTTPS_ONLY=true
PUBLIC_HTTPS_ONLY=
# Change to the port you want the app to listen on (default: 5173)
# Example: PORT=80
PORT=5173
# Set this to true if you want to disable public signups (default: false)
PUBLIC_SIGNUP_DISABLED=false
3. Build and run the container​
Now we'll use the run-dev.sh script as a shortcut to run the container for PocketBase and run the application in development mode:
chmod +x ./run-dev.sh && ./run-dev.sh
4. Start developing!​
Congratz! You can now open your favorite IDE and start tinkering! Go to the http://localhost:5173 to see the changes in real time, thanks to hot-reloading built into Vite.