Koko: The fun way to budget.

This project was created by a team of 7 students as part of the Accenture Tech Bootcamp Melbourne for 2026. The goal was to create a fun and engaging budgeting app that helps university students manage their finances effectively in this cost of living crisis.

It is a full-stack application built with a React/TypeScript-based frontend, Python backend and agentic AI integration via AWS Strands. The app allows users to enter in their grocery and petrol preferences, which are then used to generate a personalised shopping plan. This is all wrapped in a gamified interface that rewards users for sticking to their budget via a leaderboard, streaks and other fun features.

It also has first-class support for PWA technology, allowing the phone-centric university students of today to easily install the app on their phones and access it on the go, without needing the hassle of downloading from an app store.

---

Project Setup Instructions

This project is a React frontend built using Vite. Follow the steps below to run the app locally.

1. Prerequisites

Make sure you have Node.js installed.

Check with: node -v npm -v

2. Navigate to the React app

cd tech-bootcamp

Make sure this folder contains: package.json

3. Install dependencies

npm install

4. npm run dev

Vite will output a local URL, usually: http://localhost:5173

Common Commands

Install deps: npm install

Install deps: npm install

Run dev server: npm run dev

Preview build: npm run preview

Run on MacOS and access via Android Emulator

npm run dev -- --host 0.0.0.0 --port 5173

Enter 10.0.2.2:5173 in Chrome.

Run on MacOS and access via iOS Emulator

npm run dev:mobile

Enter http://localhost:5173/ in Safari, Share > Save to Home Screen,