GraceWays

Inspiration

Small animal rescue organizations save lives every day, but their information is often scattered across messages, notebooks, spreadsheets, photographs and different devices. This makes collaboration, veterinary care, adoption and long-term documentation unnecessarily difficult.

GraceWays was inspired by the work of independent animal welfare volunteers and by SunCats, a small cat rescue organization in Greece that can become the first pilot organization. Every rescued animal has a unique story, and that story should not disappear when a phone, application or team member changes.

What GraceWays does

GraceWays is a free and open-source foundation for structured, portable digital animal records.

The working prototype allows an organization to:

• record an animal’s identity, rescue story, character and current status
• document health information and internal notes
• generate a unique animal record ID and safe file name automatically
• add images, videos and audio recordings by drag and drop
• see a live Markdown preview while completing the record
• load a complete example record for the cat Sissi
• download the record as a readable Markdown file
• export the record together with its media in an organized ZIP folder

The prototype requires no account, database or proprietary file format. The organization keeps control of its own data, and the files remain readable and reusable outside GraceWays.

How I built it

GraceWays is currently a browser-based prototype built with HTML, CSS and JavaScript and deployed through Cloudflare Pages. Markdown with YAML frontmatter serves as the portable source of truth for every animal record.

I used Codex with GPT-5.6 throughout the development process. Codex helped me translate the original animal-welfare idea into a structured data model and a working application. It supported the implementation and debugging of automatic IDs, safe file names, media handling, live Markdown previews and Markdown and ZIP exports.

GPT-5.6 also helped me examine architectural decisions, refine the user experience and turn complex requirements from animal rescue work into a clear workflow. I provided the domain knowledge, reviewed the decisions and repeatedly tested the generated records and downloads.

Challenges

One major challenge was creating a record structure that is detailed enough for real animal welfare work while remaining simple for small volunteer organizations.

Another challenge was handling different media types and producing organized exports without requiring a backend or database. The prototype also had to distinguish honestly between what already works today and what belongs to the future full-stack platform.

What I learned

I learned that open formats can provide a strong foundation for collaboration. A Markdown animal record is human-readable, machine-readable and portable across tools and countries.

I also learned how a non-technical builder with practical domain knowledge can use Codex and GPT-5.6 as development partners. They helped me move from an idea and a collection of requirements to a functioning public prototype.

What I am proud of

GraceWays now demonstrates the complete journey from entering information to downloading a portable animal record. The example profile makes the workflow understandable even for someone seeing the platform for the first time.

The prototype is publicly available at graceways.dev.

What is next

The next step is to develop GraceWays into a modular open-source platform with:

• organization workspaces and team roles
• multilingual animal records and publishing
• adoption, foster and sponsorship workflows
• website and social-media outputs generated from the same record
• customizable websites for independent rescue organizations
• a worldwide network that makes participating organizations and their animals visible

SunCats can become the first pilot organization, but the long-term vision is larger: connecting independent animal rescue groups while allowing every organization to remain autonomous and retain control of its data.

GraceWays turns scattered information into animal records that remain open, portable and useful — so people can work together more effectively and more animals can be helped.

Built With

• cloudflare
• codex
• css
• gpt-5.6
• html
• javascript
• jszip
• markdown
• openai
• pages
• yaml