# Starting a Project
The Agoric platform is at the beta stage. It has not yet been formally tested or hardened. Do not use for production purposes.
This document shows how to start a new Agoric project. Our demos are called Dapps (decentralized applications), which typically have a browser-based user interface, a public API server, and a contract running on the Agoric blockchain.
Before doing the steps given in this document, be sure you have done the necessary prerequisites specified in Before Using Agoric.
For complete documentation on the Agoric CLI commands (those starting with
agoric) used here,
see the Agoric CLI Guide.
For starting a local chain with multiple users, making it possible to develop and test multiuser Dapps, also see the Agoric CLI Guide.
Also, for what needs to be done after you modify a project's code, see Development Cycle
|1||Go to or open a shell and ||When you initialize your project/Dapp in the next step, its initial code is copied into your current directory (permissions allowing).|
|2||Run ||Initializes a Dapp (Decentralized application)
There are optional arguments that let you specify which project you want copied into the specified directory. By default, their values are set to use the Fungible Faucet Dapp we wrote to provide a simple skeleton for a smart contract. To specify a different project, use the optional arguments:
Learn more about the available dapp templates.
If this doesn't work, use
|3|| ||Move to the directory where your project (the demo) is located.|
Note: When on a Mac, you must first install Xcode.
(leave this shell up with the process running)
|Start the Agoric VM. |
|6||Open another shell, go to your ||For the remainder of this table, we call this the deploy shell.
Use the same project directory name and location as you used in Step 2. In this example, we used
|8||In the deploy shell, ||This starts the demo project's UI development server.|
|9||Go to a browser and open ||If you used the |
|10||To open your Wallet UI in a browser tab, ||Running |