Skip to content

Commit 484d6c2

Browse files
Merge pull request #646 from microsoft/psl-us-21984
docs: added readme for local setup
2 parents 237f689 + f3f486b commit 484d6c2

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

docs/LocalSetupGuide.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Guide to local development
2+
3+
## Requirements:
4+
5+
- Python 3.10 or higher + PIP
6+
- Azure CLI, and an Azure Subscription
7+
- Visual Studio Code IDE
8+
9+
## Local Setup:
10+
11+
Follow these steps to set up and run the application locally:
12+
13+
### 1. Open the src Folder
14+
Navigate to the `src` folder of the repository using Visual Studio Code.
15+
16+
### 2. Configure Environment Variables
17+
- Navigate to the `src` folder and create a `.env` file based on the provided `.env.sample` file.
18+
- Update the `.env` file with the required values from your Azure resource group in Azure Portal App Service environment variables.
19+
- Make sure to set APP_ENV to "**dev**" in `.env` file.
20+
21+
### 3. (Optional) Python Virtual Environment
22+
- Navigate to the `src` folder, create and activate your virtual environment `venv` under `src` folder.
23+
24+
### 4. Start the Application
25+
- Run `start.cmd` (Windows) or `start.sh` (Linux/Mac) to:
26+
- Install backend dependencies.
27+
- Install frontend dependencies.
28+
- Build the frontend.
29+
- Start the backend server.
30+
31+
### 5. Access the Application
32+
Once the app is running, open your browser and navigate to [http://127.0.0.1:5000](http://127.0.0.1:5000).

0 commit comments

Comments
 (0)