You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/copilot-instructions.md
+35-3Lines changed: 35 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,13 +12,21 @@
12
12
-**Key Dependencies**: Compose Multiplatform, Kobweb Silk, Material Web Components
13
13
-**Current Version**: 0.6.0-SNAPSHOT
14
14
15
+
<tool_calling>
16
+
You have the capability to call multiple tools in a single response. For maximum efficiency, whenever you need to perform multiple independent operations, ALWAYS invoke all relevant tools simultaneously rather than sequentially. Especially when exploring repository, reading files, viewing directories, validating changes or replying to comments.
17
+
</tool_calling>
18
+
15
19
## Build Instructions and Environment Setup
16
20
17
21
### Prerequisites
18
22
-**JDK 17**: Required (as specified in GitHub Actions workflows)
19
-
-**Network Access**: Required for initial builds to download Android Gradle Plugin and Kobweb dependencies
23
+
-**Network Access**: Required for initial builds to download Android Gradle Plugin and other dependencies
20
24
-**Gradle 9.1.0**: Automatically handled by wrapper
21
25
26
+
**IMPORTANT**: Initial builds require internet access for dependency resolution. The project cannot build in fully offline environments.
27
+
28
+
**IMPORTANT**: If the project uses snapshot dependencies of other `com.huanshankeji` libraries, especially in a branch other than `main` such as `dev`, refer to the setup instructions at <https://github.com/huanshankeji/.github/blob/main/dev-instructions.md#about-snapshot-dependencies-of-our-library-projects>.
29
+
22
30
### Essential Repository Setup
23
31
24
32
No special repository setup is required - all dependencies are available from standard repositories (mavenCentral, google).
@@ -36,7 +44,7 @@ No special repository setup is required - all dependencies are available from st
36
44
```
37
45
**Important**: Always run `publishToMavenLocal` first when making changes, as mentioned in CONTRIBUTING.md. This publishes libraries to your local Maven repository so dependent projects can use your changes.
38
46
39
-
#### 3. Running Tests and Checks
47
+
#### 3. Running Tests and Checks (Essential Commands - validated and working)
40
48
```bash
41
49
./gradlew check
42
50
```
@@ -67,6 +75,20 @@ No special repository setup is required - all dependencies are available from st
67
75
68
76
4.**Gradle Daemon**: May timeout on first runs. Use `--no-daemon` flag if needed: `./gradlew check --no-daemon`
69
77
78
+
### Build Timing and Known Issues
79
+
80
+
**Timing Expectations**:
81
+
- First build: 5-10 minutes (includes dependency resolution and Wasm compilation)
82
+
- Subsequent builds: 1-3 minutes
83
+
-`publishToMavenLocal`: 3-5 minutes
84
+
-`check` execution: 2-5 minutes (limited tests)
85
+
- Demo builds: 2-4 minutes
86
+
87
+
**Common Issues**:
88
+
-**Wasm Compilation**: Requires 2GB+ heap memory (pre-configured in gradle.properties)
89
+
-**Network Dependencies**: Cannot build offline, requires internet for initial setup
90
+
-**Platform-specific builds**: Some targets may be disabled on certain OS (use `--continue` flag)
91
+
70
92
## Project Architecture and Layout
71
93
72
94
### Module Structure
@@ -125,6 +147,8 @@ repositories {
125
147
}
126
148
```
127
149
150
+
**Note**: All dependencies are available from standard repositories. If working with snapshot dependencies of other `com.huanshankeji` libraries, additional setup may be required as per organization instructions.
151
+
128
152
#### Key Dependencies
129
153
-**Kotlin**: 2.2.20 with Compose Compiler
130
154
-**Compose Multiplatform**: 1.9.0
@@ -157,6 +181,12 @@ repositories {
157
181
-**Code Style**: IntelliJ IDEA Code Cleanup and Reformat Code applied project-wide
158
182
-**Limited Testing**: Project acknowledges "limited number of tests"
159
183
184
+
#### Architecture Notes
185
+
-**Multi-module**: Each feature area is a separate Gradle subproject
186
+
-**Expect/Actual Pattern**: Platform-specific implementations using Kotlin Multiplatform patterns
187
+
-**Convention Plugins**: Custom build logic in `buildSrc` for consistency across modules
188
+
-**Target Platforms**: Sophisticated setup targeting 6+ platforms with different implementation strategies
189
+
160
190
### Root Directory Files
161
191
```
162
192
.gitignore # Standard exclusions plus .kotlin, local.properties
-**Limited Test Coverage**: Don't expect comprehensive test suites - focus on build and demo validation
188
-
-**Platform Complexity**: This is a sophisticated multiplatform project with 6+ target platforms and complex expect/actual patterns
218
+
-**Platform Complexity**: This is a sophisticated multiplatform project with 6+ target platforms and complex expect/actual patterns
219
+
220
+
**Trust these instructions**: This information has been validated through actual command execution and file inspection. Only search for additional information if these instructions are incomplete or found to be incorrect.
0 commit comments