Shelterflex (Avalanche)

Personal Avalanche (EVM) implementation of Shelterflex.

This repository is organized as three projects:

• frontend/ - Next.js web app
• backend/ - Node.js (TypeScript + Express) API
• contracts/ - Solidity smart contracts (Foundry)

Note: contracts/lib/forge-std is included as a git submodule. When cloning this repo, use:

git clone --recurse-submodules https://github.com/Shelterflex/avalanche.git

Prerequisites

• Node.js 20+
• npm
• Foundry (forge)

Quickstart

Frontend

cd frontend
npm install
npm run dev

Backend

cd backend
npm install
cp .env.example .env
npm run dev

Contracts

cd contracts
forge test
forge build

Contributing

Contributions are welcome.

• Please create a branch and open a Pull Request.
• If your PR changes UI, include screenshots (or a short screen recording).

See CONTRIBUTING.md for the workflow and required checks.