{"id": "writing_plugins:writing-plugins-static-assets", "page": "writing_plugins", "ref": "writing-plugins-static-assets", "title": "Static assets", "content": "If your plugin has a  static/  directory, Datasette will automatically configure itself to serve those static assets from the following path: \n             /-/static-plugins/NAME_OF_PLUGIN_PACKAGE/yourfile.js \n             Use the  datasette.urls.static_plugins(plugin_name, path)  method to generate URLs to that asset that take the  base_url  setting into account, see  datasette.urls . \n             To bundle the static assets for a plugin in the package that you publish to PyPI, add the following to the plugin's  setup.py : \n             package_data = (\n    {\n        \"datasette_plugin_name\": [\n            \"static/plugin.js\",\n        ],\n    },\n) \n             Where  datasette_plugin_name  is the name of the plugin package (note that it uses underscores, not hyphens) and  static/plugin.js  is the path within that package to the static file. \n             datasette-cluster-map  is a useful example of a plugin that includes packaged static assets in this way.", "breadcrumbs": "[\"Writing plugins\"]", "references": "[{\"href\": \"https://github.com/simonw/datasette-cluster-map\", \"label\": \"datasette-cluster-map\"}]"}