Maak Je Eerste Project
Stap-voor-stap handleiding voor het maken en configureren van je eerste project.
Creating your first project in TurtleApps is straightforward. This guide walks you through the process step by step.
What is a Project?
A project in TurtleApps represents a single codebase or application. Each project has its own:
- Repository connection (GitHub or managed)
- Environment variables
- Team members and permissions
- Ticket history and deployments
Creating Your Project
Navigate to Projects
From your dashboard, click "Projects" in the sidebar, then click the "New Project" button.
Projects page with New Project button
[Screenshot placeholder]
Enter Project Details
Fill in the basic information for your project:
- Project Name — A descriptive name for your project
- Description — What the project is about (helps AI understand context)
- Tech Stack — Select your primary technologies
Choose Repository Type
You have two options:
- Managed Repository — We host the code for you (perfect for starting fresh)
- GitHub Repository — Connect your existing repo (requires GitHub integration)
Repository type selection
[Screenshot placeholder]
✨Start with Managed
If you're just exploring TurtleApps, start with a managed repository. You can always migrate to your own GitHub repo later.
Configure Environment
Set up your development environment:
- Add any required environment variables
- Configure build commands if needed
- Set up preview environment settings
Invite Team Members (Optional)
If you're working with a team, you can invite members now or do it later. Each member can have different roles:
- Developer — Create tickets and view deployments
- Product Owner — Approve deployments and manage tickets
- Admin — Full access including settings
Project Dashboard
After creating your project, you'll land on the project dashboard where you can:
- Create new tickets
- View recent activity
- Monitor deployments
- Access project settings
Project dashboard overview
[Screenshot placeholder]
Connecting GitHub (Optional)
If you chose to connect a GitHub repository:
# Make sure your repository has:
# 1. A valid package.json (for Node.js projects)
# 2. Proper .gitignore
# 3. At least one branch (usually main or develop)⚠️GitHub Permissions
TurtleApps requires read/write access to your repository to create branches and commit code. We never modify your main branch directly — all changes go through pull requests.
Next Steps
Congratulations! You've created your first project. Now you're ready to create your first ticket and see AI development in action.
Was dit artikel nuttig?