Skip to content

standard document directory#2884

Merged
qingqing-ux merged 1 commit into
goplus:uifrom
yueman920:Standard-document-directory
Mar 2, 2026
Merged

standard document directory#2884
qingqing-ux merged 1 commit into
goplus:uifrom
yueman920:Standard-document-directory

Conversation

@yueman920
Copy link
Copy Markdown

Background

To facilitate file management, the file structure has been reorganized.

Modifications

  • Added a template file, placing the current spx and ai canvas rendering modules into this file, and made corresponding adjustments to the images file.

  • Added an archive file, placing the backup scheme of the builder style from the original spx folder into it, and creating an images file.

Scope of Impact

  • File Directory

@gemini-code-assist
Copy link
Copy Markdown

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request primarily focuses on a significant refactoring of the project's user interface file structure. By introducing a dedicated templates directory, it centralizes various canvas rendering modules and associated assets, aiming to streamline file management and enhance organization for future development. This change improves maintainability by grouping related UI components.

Highlights

  • File Structure Reorganization: The project's user interface file structure has been reorganized to improve overall file management and clarity.
  • Introduction of templates Directory: A new ui/templates directory was introduced, and several existing ai-canvas and spx related files were moved into this new centralized location.
  • Path Adjustments: Relative image paths within the ai canvas.pen file were updated to correctly reference assets from their new location within the templates directory.
  • Version Update: The internal version of the ai canvas.pen file was incremented from "2.7" to "2.8".

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • ui/ai-canvas/ai canvas.pen
    • Renamed to ui/templates/ai-canvas/ai canvas.pen.
    • Updated internal version from "2.7" to "2.8".
    • Adjusted image URL path from ./点阵.png to ./images/点阵.png.
  • ui/ai-canvas/ai-structure.json
    • Renamed to ui/templates/ai-canvas/ai-structure.json.
  • ui/spx/images/bg.svg
    • Renamed to ui/templates/spx/images/bg.svg.
  • ui/spx/pencil design draft reproduction workflow.md
    • Renamed to ui/templates/spx/pencil design draft reproduction workflow.md.
  • ui/spx/shadcn.pen
    • Renamed to ui/templates/spx/shadcn.pen.
Activity
  • No recorded activity for this pull request yet.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request reorganizes the project structure by moving the spx and ai canvas modules into a new templates directory. The changes are consistent with this goal, including an update to an image path in ai canvas.pen.

My main feedback is regarding the pull request description, which mentions creating an archive file/directory. This change doesn't seem to be included in the current set of patches. Could you please clarify if this is intended for a future PR or if it was missed?

Additionally, I've noticed the use of non-ASCII characters in asset filenames. While this might work in your current environment, it can lead to compatibility and URL encoding issues. I've left a specific comment with a suggestion on a line that was part of the changes.

"type": "image",
"enabled": true,
"url": "./点阵.png",
"url": "./images/点阵.png",
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For better compatibility and to avoid potential issues with URL encoding across different systems, it's a good practice to use only ASCII characters for filenames of web assets. I'd suggest renaming 点阵.png to something like dot_matrix.png and updating the URL here accordingly. This would also apply to other assets with non-ASCII filenames in the project.

            "url": "./images/dot_matrix.png",

@@ -1,5 +1,5 @@
{
"version": "2.7",
"version": "2.8",
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unexplained version bump

The "version" field is bumped from "2.7" to "2.8" but no versioning scheme for .pen files is documented anywhere. The only content change in this file is the path fix ./点阵.png./images/点阵.png. If this version field has no defined semantics, the bump adds noise; if it does track design revisions, the rationale should be noted. Also, none of the other .pen files touched in this PR had their version updated, making this inconsistent.

"url": "../images/用户头像.png",
"mode": "stretch"
}
],
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Undocumented functional change: empty URLs populated

Several entries previously had "url": "" (empty/broken references) and are now set to "../images/用户头像.png". This is a functional fix, not just a path adjustment, but it is not mentioned in the PR description. It is worth calling out explicitly so reviewers know this was intentional and the correct asset is being referenced.

"mode": "fill"
},
"width": 60,
"height": 60,
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Undocumented rendering mode changes

Several sprite.png references had "mode": "stretch" changed to "mode": "fill" here and in a few other hunks. This is a rendering behavior change — not just a path correction — bundled into a directory-reorganization PR with no explanation. Please note the intent in the PR description so reviewers and future contributors can understand and revert it independently if needed.

@fennoai
Copy link
Copy Markdown
Contributor

fennoai Bot commented Feb 28, 2026

The reorganization is clean overall and the relative path corrections are structurally correct. A few items worth addressing:

  1. Duplicate binary assets: sprite.png, ai canvas logo.png, 地图背景.png, and 用户头像.png now exist identically in both ui/archive/images/ and ui/templates/spx/images/ (~645 KB of redundancy). If archive/ is a historical backup, consider referencing the templates/ copies instead of storing them twice.

  2. README documents a non-existent system/ directory: ui/README.md lists system/ (Design Tokens) in the structure, but this directory was never created. This will mislead contributors.

  3. Functional changes mixed into a structural PR: Mode changes (stretchfill) and empty-URL fixes are bundled with path corrections — worth noting explicitly in the PR description.

  4. PR description terminology: Uses "file" where "directory" is meant, and omits mention of ui/ai-canvas/ being reorganized.

@qingqing-ux qingqing-ux merged commit bbd9eb4 into goplus:ui Mar 2, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants