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.mdcovering 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.