Goal
After this step, you will:
- have a MixelPixel project on your local machine
- have opened it in IntelliJ
- be ready to build and start developing
[!important]
Make sure you completed [[Nexus & Gradle Setup|Nexus%20&%20Gradle%20Setup]] before cloning a project.
Otherwise, the project will most likely fail to build.
1. Choose a repository
Open GitLab: https://gitlab.com/groups/mixelpixelgbr
Select a repository you want to work on (e.g. the "Build your first feature" repository).
2. Copy the repository URL
Inside the repository:
- Click the Code button
- Copy the HTTPS URL (Clone with HTTPS)
3. Clone using IntelliJ (recommended)
3.1 Open clone dialog
In IntelliJ:
- open the welcome screen
- click Clone Repository or Get from VCS
(or: File → New → Project from Version Control)
3.2 Paste repository URL
- paste the URL you copied
- choose a local folder
3.3 Clone
Click Clone
IntelliJ will now download the project and open it.
4. Alternative: Clone via Git (manual)
If you prefer using Git directly:
Open a terminal and run:
id="k3z2df"
git clone <repository-url>
Then open the project folder in IntelliJ.
5. Open the project
After cloning:
- IntelliJ should automatically open the project
- if not: open the folder manually
[!tip]
On Windows, you can exclude your project folder from Windows Defender to improve performance.
6. Let Gradle load
When the project opens:
- IntelliJ will detect a Gradle project
- wait for Gradle to sync and download dependencies
This may take a moment on first setup.
[!warning]
Do not interrupt this process!
7. Verify the setup
If everything is correct:
no red imports project loads successfully no dependency errors
8. Common Issues
Authentication error
You most likely skipped [[GitLab Access & Token|Getting-Started/Setup-Guide/GitLab-Access-&-Token]]
Build fails / missing dependencies
You most likely skipped [[Nexus & Gradle Setup|Nexus%20&%20Gradle%20Setup]]
Next Step
Continue with: [[SSH Key Setup|Getting-Started/Setup-Guide/SSH-Key-Setup]]