Using Ona

What is Ona?

Ona is a cloud development environment with all the necessary tools and dependencies, allowing you to focus on building your Cedar application without worrying about the setup. Get started quickly and efficiently by launching CedarJS inside Ona!

Getting started

Click on the Run in Ona button:

This will launch Ona and ask you to configure a new workspace. Click continue.

Ona will then begin to build your workspace using Dev Containers and Automations. This may take several minutes as it:

1. Sets up the development environment
2. Installs dependencies
3. Creates a test project linked to the framework
4. Starts the development server automatically

What's going on behind the scenes:

• Ona is setting up the environment
• It installs our recommended VS Code plugins:
  • ESLint
  • Git Lens
  • VS Code Language - Babel
  • VS Code Version Lens
  • Editor Config
  • Prisma
  • VS Code GraphQL
• It runs our Create Cedar App which will install the latest stable version of CedarJS. We're setting this project to use TypeScript, however, you can change it to JavaScript if you prefer.
• It runs yarn install, adding all the dependencies for the project
• Changes the database over to Postgres

Once everything is up and running, you can click on the Ports tab:

You can click on the address or the globe icon to open that particular port in a new tab.

• Port 5432 is the database. So, if you click on that port, you'll probably see a "Port 5432 Not Found" error, but it is working!

• Port 8910 is your frontend

• Port 8911 is your backend and will show you a list of all available functions. If you add /graphql to the end of the URL, you should see the GraphQL Playground

How to use Gitpod (Ona)

If you have an existing project, you can still use Ona:

1. Take any repository within GitHub and append https://app.ona.com/# to the URL. This will quickly launch a Ona environment.
2. Within the Terminal, run yarn install to install all the dependencies