Mini-foo

A simple evaluation results viewer with a React frontend and Express backend.

Project Structure

mini-foo/
├── app/                # React frontend application
│   ├── public/        # Static files
│   ├── src/           # Source files
│   └── package.json   # Frontend dependencies
└── server/            # Express backend application
    ├── src/           # Source files
    ├── bootstrap.ts   # Database initialization
    └── package.json   # Backend dependencies

Getting Started

1. Install dependencies:

npm install

2. Start the server:

npm start

The server will run on http://localhost:8085

Frontend Setup

1. Navigate to the app directory:

cd app

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

The application will open in your browser at http://localhost:3007

API Endpoints

• GET /evals - Retrieve all evaluations with their results

Technologies Used

Frontend

• React
• TypeScript
• Vite
• Vitest
• Testing Library

Backend

• Express
• better-sqlite3
• TypeScript
• Node.js

Development

Available Scripts

From the root directory:

• npm start - Start both frontend and backend servers
• npm test - Run tests for all workspaces
• npm run lint - Run ESLint on all files
• npm run format - Format code with Prettier

From the app directory:

• npm run dev - Start the Vite development server
• npm run build - Build the app for production
• npm test - Run tests with Vitest
• npm run preview - Preview the production build

Code Structure

• Frontend code is in app/src/
• Backend code is in server/src/
• Database schema and sample data are in server/bootstrap.ts
• API models are in server/src/models/

Notes

• The frontend runs on port 3007 to avoid conflicts with other services
• The backend uses SQLite for data storage
• CORS is enabled on the backend to allow frontend requests