关于Atlassian Connect Express Confluence Macro打包与上传文件的咨询

Great question—this is a common point of confusion when getting started with Atlassian Connect apps, so let’s break this down clearly:

• 绝对可以跳过node_modules文件夹
  The node_modules directory holds your local development dependencies (like build tools, linters, or dev-only libraries). Atlassian’s servers have no use for these files—uploading them would only waste space, slow down your deployment, and expose unnecessary code. You should never include this folder in your production upload.

• 你需要上传的核心内容
  Atlassian only needs access to the files required to run your plugin and validate its configuration:

  1. atlassian-connect.json: This file must be reachable via your HTTPS endpoint (usually placed at the root of your hosted directory, though you can specify a custom path in your Atlassian Cloud setup if needed).
  2. 编译/打包后的静态资源: This includes minified js, css, html files, images, fonts, or any other assets your plugin uses to render its UI. These are typically found in a dist or build folder after running your project’s build command (like npm run build).
  3. 后端代码（如果有）: If your plugin includes a backend service (e.g., an Express server), upload your source code but run npm install --production on the server to install only production dependencies (avoiding dev-only packages in node_modules).

• 额外实用提示

  • Always use your project’s build tool (Webpack, Vite, etc.) to bundle and minify your frontend code before uploading. This reduces file sizes, improves load times, and keeps your uncompiled source code private.
  • Double-check that your HTTPS server correctly serves all uploaded files with the right permissions—Atlassian’s validation process will fail if it can’t access atlassian-connect.json or your plugin’s assets.

内容的提问来源于stack exchange，提问作者Tim Nuwin