Mladi Pirati Beacon

Creating a project

The steps from a new idea to a deployed Mladi Pirati project.

Pick the stack

Use the tech stack page to choose a project type (static site, web app or mobile app) and the matching auth setup.

Start from a template

Create your project from the matching template. Templates come with TypeScript, linting and project structure already set up, so don't scaffold from scratch.

Create the repository

The repository lives in the Mladi Pirati GitHub organization.

  • Name repositories in lowercase kebab-case, e.g. volilni-kompas.
  • Add a short README.md covering what the project is, how to run it, and who maintains it.

Set up environment variables

List every variable the app needs in a committed .env.example, with no values. Keep real values in your local .env, which must be in .gitignore.

Request the services you need

Before your first deploy, request what the project needs:

  • Deployment on Dokploy: see Dokploy
  • S3 bucket on Garage: see S3 storage
  • Keycloak client for internal apps: see Authentication
  • Expo / app store setup for mobile apps: see Expo

All of these go through a service access request.

On this page