Eat Better Project Setup Guide

This guide explains how to set up and run the Eat Better project on macOS.

Prerequisites

Before starting, ensure you have the following installed:

1. Git: Install Git or use brew install git.
2. .NET 9.0 SDK: Download .NET 9.0
   • Verify installation: dotnet --version
3. Node.js & npm: Download Node.js (LTS recommended) or use brew install node.
   • Verify installation: node -v and npm -v

Getting Started

1. Clone the Repository

git clone <repository_url>
cd eat-better

2. Using Antigravity

Antigravity is your AI coding assistant. You can use it to help develop features, debug code, or understand the project.

• Chat: Open the AI chat panel to ask questions or request changes (e.g., "Add a new page for users").
• Context: Antigravity uses your open files as context. Open the file you want to discuss to get better results.
• Commands: You can ask it to run terminal commands, create files, or refactor code directly.

3. Start the Backend

The backend is built with ASP.NET Core.

1. Navigate to the backend directory:

   cd backend

2. Start the server:

   dotnet run

3. The backend will start on http://localhost:5265. All API requests are handled here.

4. Start the Frontend

The frontend is a Vite + React + TypeScript application.

1. Navigate to the frontend directory:

   cd frontend

2. Install dependencies (first time only):

   npm install

3. Start the development server:

   npm run dev

4. Open your browser to http://localhost:5173.

Deployment (Oracle Cloud / Docker)

This project is configured to run as a single Docker container containing both Backend and Frontend.

1. Build the Docker Image

docker build -t eat-better-app .

2. Run with Persistent Database

To ensure your database survives container restarts (updates), you must use a volume mapped to /app/data.

# Create a data directory on your host
mkdir -p ~/eat-better-data

# Run the container
docker run -d \
  --name eat-better \
  --restart unless-stopped \
  -p 80:8080 \
  -v ~/eat-better-data:/app/data \
  -e ConnectionStrings__DefaultConnection="Data Source=data/cms.db" \
  eat-better-app

3. Updating

To update the app:

1. git pull
2. docker build -t eat-better-app .
3. docker stop eat-better && docker rm eat-better
4. Run the docker run command again.

Troubleshooting

• Address already in use: If you see an error about port 5265 or 5173 being in use:
  • Find the process: lsof -i :5265
  • Kill it: kill -9 <PID>