Skip to content

Under Construction

This section and others in Getting Started with SceneryStack are under heavy revisement and will be updated by the end of 2024.

Developing a Simulation

If you're looking to create a STEM-focused, interactive simulation then you're in the right place.

Setting Expectations

Developing a full simulation can be an extensive task. You will need (or need to learn) the development knowledge and skills to use the tools to create a simulation from scratch. However, we've seen many examples of success from community members. Small test projects, academic projects (e.g., education research for a Ph.D.), or open-source curriculum projects have all successfully developed custom simulations, leveraging SceneryStack (See Simulation Examples). It requires expertise in design and JavaScript/TypeScript, but it is very possible for dedicated developers and teams. Please reach out to us through the community discussion forum for support from the community and maintainers.

If your dream is to one day have your simulation hosted on the PhET website - then if you have made significant progress and you are committed to your STEM simulation, reach out to [email protected] to discuss opportunities.

If you are a commercial organization interested in making new simulations

See the Source Code page of our website for more information.

Getting Started

For anyone interested in setting up a development environment, the Development Overview is the best place to start. It provides a comprehensive introduction to the processes, tools, and best practices for developing with the libraries contained in SceneryStack. It also serves as the best starting point for creating interactive simulations, specifically.

You will likely want to check out some of the basics of Scenery and the libraries packaged in phet-lib. Don't forget to get up to speed on all the necessary software design patterns and try out some introductory exercises.

Documentation and Resources

  • If you're using SceneryStack, you'll likely be using Scenery, the primary view library that many other libraries rely on. See Scenery's documentation here!

  • A community-created guide from HNM Simulations provides a lot of helpful tips, though some information may be out of date.

  • Look through examples! There are well over one hundred PhET simulations and many community-created simulations to use as resources and inspiration. We look forward to learning about your creations!

  • The simulation Molarity is a good sim to look at since it is simple and will give you a good overview of the guts of the SceneryStack and simulation architecture (you will see some code related to accessibility, which can be illustrative but not required).

  • It may be helpful to check out the Code Review Checklist used by PhET Simulation developers before publishing a simulation. It contains a lot of checks and extra resources which should help improve the quality of your simulation!

If you have any questions or need further assistance, please head over to the Discussions or chat platforms.