Project Info
This project did not submit a demo video on Devpost.
Inspiration
Inspired by previously played turn based games, Boss raids, and RPGs, want to give a very quick and accessible experience of role playing as a character and fighting bosses with your friends. All of this without grinding for hours upgrading your character, and with so much customization available.
What it does
We generate our own character based on our Character Name and Description, and we write/describe actions we do. It uses a Boss Agent and a GameMaster Agent with tools and prompts to calculate damage and effects, with long term memory to give it more freedom and capability to assess new actions.
How we built it
Built using Next.js Frontend and Express.js Backend with Socket.io to connect up to 4 players. Uses Letta for creating and easy access to AI agents, tools and long term memory.
Challenges we ran into
Optimizing between using AI to control the flow of the game and our own algorithms/mechanics.
Accomplishments we're proud of
Building a fully functional game prototype within 1 day and solo.
What we learned
How AI agents and LLMs interact with context and prompt provided, and integrating that within our application. How to add tools for an LLM to use and communicate with each other.
What's next
Game testing, mechanics refinement, Output Formatting improvement, Creating our own bosses, Scaling for multiple rooms and saving game states/previous rooms in a database, adding new features.
This is a Next.js project bootstrapped with create-next-app.
Getting Started
First, run the development server:
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
Open http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.
This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.
Learn More
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!
Deploy on Vercel
The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.
Check out our Next.js deployment documentation for more details.
Analysis
View
Metric
- 12
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- JavaScriptIn code
- Next.jsIn code
- ReactIn code
- Tailwind CSSIn code
- TypeScriptIn code
- ExpressClaimed
6 of 7 appear in the indexed code. 1 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
115 KB
Source files
37
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
JonathanSaleh123/boss-hunter-frontend
44 files · 3.7 MB · @ 3446b46
Structure
Interface
25 files · 57%Screens, components and styles rendered to the user.
API & routing
3 files · 7%Request entry points: routes, handlers and controllers.
Application logic
6 files · 14%Domain rules, services and shared utilities.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- TypeScript94%
- Markdown5%
- CSS1%
- JavaScript0%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
package.json
npm · 19- @auth0/nextjs-auth0
- @letta-ai/letta-client
- framer-motion
- lucide-react
- next
- next-auth
- postcss
- react
- react-dom
- socket.io-client
- +9 more
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This project’s features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.