Skip to content

Playground for testing web extensions and web customization

License

Notifications You must be signed in to change notification settings

pixiebrix/playground

Repository files navigation

playground

Playground for testing extensions and web customization.

https://pbx.vercel.app/

Contribute

Each folder is its own standalone project so we never have dependency conflicts.

Some projects might be used for testing, it's often better to create a new project.

Adding a static project

  1. Create a folder in static/
  2. Add at least an index.html file (like static/my-demo/index.html)
  3. Access it at https://pbx.vercel.app/my-demo/

Adding a project with a build

  1. Create a folder in source/ with the source files, like source/my-demo/

    • Treat this folder as a self-contained project with its own package.json file
  2. Add the install and build steps in its own build.sh file (like source/my-demo/build.sh)

    • it should include the exact header as other build.sh scripts
    • it should output files in public/
  3. Run build.sh on your computer, like bash source/my-demo/build.sh

  4. Commit both source and public folders

  5. If your project is a single-page APP (i.e. all paths point to index.html), you'll have to edit vercel.json too

  6. Access it at https://pbx.vercel.app/my-demo/

    • If you send a PR, you can access a temporary deployment at a custom URL like pbx-temp-pr.vercel.app/my-demo/