Gitlantis transforms your project into an ocean world where you sail a boat to explore files and folders. This guide will show you how to navigate effectively.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/liltrendi/gitlantis/llms.txt
Use this file to discover all available pages before exploring further.
Moving Your Boat
Control your boat using keyboard inputs to explore the ocean.Basic Movement Controls
Use WASD keys or arrow keys to control your boat:
- W or Up Arrow: Move forward
- S or Down Arrow: Move backward (at 50% speed)
- A or Left Arrow: Turn left
- D or Right Arrow: Turn right
- H: Sound the horn
src/browser/hooks/useBoat/keyboard/index.ts:10-35 and src/browser/hooks/useBoat/navigation/index.tsx:66-148.Understanding Boat Physics
Your boat has realistic sailing behavior:
- Acceleration: The boat gradually speeds up when moving forward or backward
- Deceleration: The boat gradually slows down when you release the keys
- Turn Speed: Steering becomes more responsive at lower speeds
- Floating Motion: When stationary, the boat gently bobs and rocks on the waves
Stationary Floating
When you’re not moving, your boat will float naturally on the ocean:
- Gentle bobbing up and down based on wave motion
- Subtle rocking and tilting for realism
- Position-based waves that respond to your boat’s location
- Multiple wave layers (primary, secondary, and choppy waves)
src/browser/hooks/useBoat/floating/index.tsx:22-73.Using the Minimap
The minimap provides a bird’s-eye view of your surroundings and helps you navigate large projects.Toggle Minimap View
Press F to toggle between normal and fullscreen minimap views.
- Normal view: Shows a small overview in the corner with 3.5x zoom
- Fullscreen view: Expands the minimap with 0.8x zoom for better visibility
src/browser/components/world/minimap/toggle.tsx:15-21 and src/browser/hooks/useBoat/keyboard/index.ts:32-34.Following the Compass
The compass helps you understand your boat’s orientation in the world.Read Compass Directions
The compass displays:
- Current heading in degrees (0-360°)
- Cardinal direction (N, NE, E, SE, S, SW, W, NW)
src/browser/hooks/useBoat/compass/index.ts:10-22.Using Breadcrumbs
Breadcrumbs show your current location in the project directory structure.View Current Path
The breadcrumb trail appears as “Exploring: [path]” and shows:
- Your current directory path
- Each folder in the path separated by ”>”
- The root project name
src/browser/components/ui/breadcrumbs/path/index.tsx:20-29.Navigate Using Breadcrumbs
Click on any folder in the breadcrumb path to jump directly to that directory:
- Click any parent folder to navigate back up the directory tree
- The current (last) folder in the path is not clickable
- Hover over folders to see them highlighted
src/browser/components/ui/breadcrumbs/path/index.tsx:58-66.Tips for Efficient Navigation
- Use the minimap for long-distance navigation across your project
- Use breadcrumbs to quickly jump back to parent directories
- Watch the compass to maintain orientation in large projects
- Use Escape to go back one directory level (see Managing Files)
- Adjust boat speed in settings if navigation feels too fast or slow (see Customizing Your Boat)