What is a Space?
A space is what we call an application or a project in NodeRun. Every NodeRun space you create includes your own server, your own files, and your own integrated database.
To create a new space, simply click on the New Space button in the upper right corner of the NodeRun website. This launches the online NodeRun IDE, which provides all the tools you need to build and deploy Node.js applications. You can start by building an app from scratch, by selecting one of NodeRun's templates, or by cloning one of your existing Git repos.
Once you publish your application, you and others can view it and try it within the NodeRun community site.
You can also edit, fork, share, like, comment, collaborate (and more!) on spaces directly within the community site.
Viewing Your Spaces
You can view all your spaces by clicking on the user dropdown menu in the upper right corner.
Our NodeRun IDE is where the work happens! Inside the IDE, you can configure your space settings, write your code, and launch runnable copies of your project as you build it.
Here are some basic NodeRun IDE concepts:
Clicking the New button gives you options to start a new instance of the IDE, create a new space, or add a file into your existing space.
Before you can launch or share your space, you have to use the the Publish button to give your space a name and set its public permissions. You can also write a short description and provide searchable keywords that describe your workspace.
The Fork button creates a new, complete copy of the space you're viewing. You can fork your own spaces or the spaces of other members.
You can you use the Launch button to run your application either within the IDE or in a separate browser tab.
If you're using the NodeRun Visual Designer to build your user interface, you can also use the Launch button to preview Rich Display screens.
With NodeRun, changes to your code go live immediately. It's a feature we call hot reloading. You don't have to publish or manually restart your server after changes are made.
Using the Contributors menu, you can add and invite other members of NodeRun to contribute to your space.
Contributors are able to open and make changes to a space just like the space owner.
NodeRun URL Patterns
Each space has its own set of URLs, where you would specify the owner and space name in the URL.
- To preview a space, use noderun.com/[owner]/[space]/
- To open a space in the IDE, use noderun.com/ide/[owner]/[space]/
- To run the application, use noderun.com/run/[owner]/[space]/
- To view the README content for a space, use noderun.com/readme/[owner]/[space]/
It is good practice to include a README.md file in your space. The README.md file should include information about your space.
The file uses markdown format. Markdown is a plain text compatible format. So, if you're new to markdown, just type the information using plain text.
NodeRun includes a Markdown editor with a live preview.
Space Thumbnail Image
We also recommend that you upload a custom thumbnail for your space. Simply click the current thumbnail in the top-right corner and select Replace Thumbnail.
If you don't provide a custom thumbnail, NodeRun will attempt to take an automatic screenshot of the app for you.
Have questions about this topic? Ask for help on our NodeRun Discussion Forum.