{"id":41143,"library":"gatsby-plugin-well-known","title":"Gatsby Plugin Well-Known","description":"Gatsby plugin (v1.0.0) that copies files from src/well-known to the .well-known directory during builds. Lightweight and purpose-built for hosting security/auth files (e.g., assetlinks.json, apple-app-site-association). Stable release with no known issues, passive maintenance. Unlike manual copy tasks, it integrates directly with Gatsby's build lifecycle.","status":"active","version":"1.0.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","gatsby","well-known"],"install":[{"cmd":"npm install gatsby-plugin-well-known","lang":"bash","label":"npm"},{"cmd":"yarn add gatsby-plugin-well-known","lang":"bash","label":"yarn"},{"cmd":"pnpm add gatsby-plugin-well-known","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Plugin takes no options. Use simple string in gatsby-config.","wrong":"plugins: [{ resolve: 'gatsby-plugin-well-known', options: { /* any options */ } }]","symbol":"gatsby-plugin-well-known","correct":"plugins: ['gatsby-plugin-well-known']"}],"quickstart":{"code":"// gatsby-config.js\nmodule.exports = {\n  plugins: ['gatsby-plugin-well-known']\n}","lang":"javascript","description":"Add the plugin to your Gatsby site config. Ensure src/well-known exists."},"warnings":[{"fix":"Manually clean public/.well-known or implement a prebuild script.","message":"Plugin copies files from src/well-known on every build. If you delete a file from src/well-known, it will NOT be removed from the public/.well-known directory.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use gatsby build to see .well-known in output, or configure webpack to serve from src/well-known.","message":"Plugin only copies files at build time. For development (gatsby develop), files are not copied.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Consider alternative solutions if more advanced directory copying is needed.","message":"This plugin may be considered passive maintenance; no new features are expected.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'app':35 'appl':34 'apple-app-site-associ':33 'assetlinks.json':32 'associ':37 'build':21,56 'built':26 'copi':10,48 'direct':52 'directori':19 'e.g':31 'file':11,30 'gatsbi':1,6,54,59 'host':28 'integr':51 'issu':43 'javascript':58 'known':5,18,42,62 'lifecycl':57 'lightweight':22 'mainten':45 'manual':47 'passiv':44 'plugin':2,7 'purpos':25 'purpose-built':24 'releas':39 'security/auth':29 'site':36 'src/well-known':13 'stabl':38 'task':49 'unlik':46 'v1.0.0':8 'well':4,17,61 'well-known':3,16,60","created_at":"2026-06-04T18:50:59.243489+00:00","updated_at":"2026-06-04T18:50:59.243489+00:00","problems":[{"fix":"npm install gatsby-plugin-well-known and ensure correct spelling in plugins array.","cause":"Plugin not installed or typo in gatsby-config.","error":"Error: The plugin gatsby-plugin-well-known is not a valid plugin"},{"fix":"Create src/well-known directory and add files you want copied.","cause":"Source directory or file missing.","error":"ENOENT: no such file or directory, open 'src/well-known/somefile'"},{"fix":"Use gatsby build to generate static files.","cause":"Running gatsby develop instead of gatsby build.","error":"File not copied to .well-known"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"gatsby-plugin-well-known","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-04","next_check":"2026-09-02","install_tag":null}}