Andamio Auth: T3 App Template with Cardano Token-Based Login

[Proposal setup] Proposal title

Please provide your proposal title

Andamio Auth: T3 App Template with Cardano Token-Based Login

[Proposal Summary] Budget Information

Enter the amount of funding you are requesting in ADA

67200

[Proposal Summary] Time

Please specify how many months you expect your project to last

5

[Proposal Summary] Translation Information

Please indicate if your proposal has been auto-translated

No

Original Language

en

[Proposal Summary] Problem Statement

What is the problem you want to solve?

Cardano wallets can connect to dApps, but production apps still need authentication to Web2 services for data and APIs. Cardano devs need wallet connectivity integrated with traditional auth systems.

[Proposal Summary] Supporting Documentation

Supporting links

• https://app.andamio.io
,
• https://docs.andamio.io

[Proposal Summary] Project Dependencies

Does your project have any dependencies on other organizations, technical or otherwise?

Yes

Describe any dependencies or write 'No dependencies'

Dependencies on Cardano wallet providers (Nami, Eternl, Flint, etc.) for wallet connectivity. We are working closely with the Mesh team on ecosystem tooling that integrates in the NodeJS stack.

[Proposal Summary] Project Open Source

Will your project's outputs be fully open source?

Yes

License and Additional Information

MIT

[Theme Selection] Theme

Please choose the most relevant theme and tag related to the outcomes of your proposal

Developer Tools

[Campaign Category] Category Questions

Mention your open source license and describe your open source license rationale.

We will use the MIT License for maximum adoption and compatibility with commercial projects. Developers need flexibility to build both open and closed-source applications. The tooling delivered in this proposal will serve the needs of both open and closed-source app developers.

How do you make sure your source code is accessible to the public from project start, and people are informed?

• Public GitHub repository from day one
• Announcement on Cardano developer forums
• Discord channels in Andamio Network Discord
• Twitter announcements with summary threads showing "What You Can Do with Andamio"
• Live sessions for developers to learn and ask questions (recorded and posted to YouTube for anyone who can't attend)

How will you provide high quality documentation?

Comprehensive README, API documentation, setup guides, and example implementations. Video tutorials for common use cases. All documentation versioned with code.

A current draft of comprehensive Andamio documentation is live at docs.andamio.io, which is updated weekly and will be refined as one of the outputs of this proposal.

[Your Project and Solution] Solution

Please describe your proposed solution and how it addresses the problem

We're delivering a production-ready T3 App (https://create.t3.gg) template that seamlessly integrates Cardano wallet authentication with traditional "Web2" services.

The T3 stack is a popular modern web development framework that combines popular, industry-leading tools: NextJS (web framework, https://nextjs.org) tRPC (API layer, https://trpc.io) Prisma (database, https://www.prisma.io) Tailwind CSS (styling, https://tailwindcss.com) and NextAuth (authentication, https://next-auth.js.org) Think of it as a pre-configured toolkit that developers use to build professional web applications quickly and reliably.

Andamio Auth replaces NextAuth, which is the T3 stack's traditional username/password authentication system, with Cardano wallet authentication. Everything else in the proven T3 stack remains unchanged, giving developers a familiar foundation with native Cardano integration.

This solution is already securing real user data at app.andamio.io. With this proposal, we're open-sourcing our production-proven code as a template with comprehensive documentation, saving developers months of complex integration work.

What we're building:

• T3 Stack Foundation: The complete, unmodified T3 toolkit that thousands of developers already know and trust
• Andamio Auth (Replacing NextAuth): Direct wallet connection to Cardano CIP-30 wallets - no usernames or passwords needed
• OAuth2 Compliance: Industry-standard token management and authorization flows for enterprise integration
• Protected Routes: Secure areas of the application that only wallet-authenticated users can access
• Database Ready: Automatic storage and retrieval of user data linked to access tokens held in the user's wallet
• 10-Minute "Getting Started" Guide: From downloading the code to running an authenticated Cardano app

[Your Project and Solution] Impact

Please define the positive impact your project will have on the wider Cardano community

Why this matters: Every Cardano application that stores user preferences, saves data, or connects to external services faces the same challenge: how to securely identify users through their wallets while integrating with traditional web infrastructure. Developers currently spend months building custom solutions. We've already built and tested ours in production.

Delivery approach:

1. Core Template (Weeks 1-3): Ship the working authentication system

2. OAuth2 Standards (Weeks 4-6): Implement OAuth2 compliance for enterprise integration

3. Documentation (Weeks 7-9): Make it accessible with a "Getting Started" guide clear documentation

4. Starter Kit (Weeks 10-12): Show real-world implementation with a full sample app

5. Andamio SDK (Weeks 13-15): Add advanced features from Andamio SDK ([https://sdk.andamio.io/](https://sdk.andamio.io/))](https://sdk.andamio.io/)) which was delivered in our Catalyst Fund 13 proposal: Andamio SDK & UTxO-RPC client

This creates a multiplier effect - each project using our template saves 2-3 months of development time and avoids common security pitfalls. With proper documentation and examples this project enables a new class of apps to be built on Cardano.

Immediate Developer Impact:

• Day 1: Clone repo, configure wallet, deploy authenticated app in 10 minutes

• Week 1: Build features instead of authentication infrastructure

• Month 1: Ship to production with field-tested security

Ecosystem Benefits:

• Time Savings: 2-3 months per project × hundreds of projects = massive acceleration

• Security: Eliminates custom auth vulnerabilities across the ecosystem

• Standards Creation: Establishes a common pattern for Cardano web auth in JS/TS development

• Onboarding: Web2 developers can build on Cardano immediately

• Integration: Andamio SDK adds token-gating, credentials, and smart contracts

Long-term Value:

• MIT License: Free forever, no vendor lock-in

• Community Sessions: 4 live workshops during development

• Continuous Updates: Maintained as core Andamio infrastructure

• Cross-Framework: Patterns applicable to any web framework

[Your Project and Solution] Capabilities & Feasibility

What is your capability to deliver your project with high levels of trust and accountability? How do you intend to validate if your approach is feasible?

The Andamio team has been building on Cardano since 2021, recently collaborating with the Cardano Foundation on strategic initiatives including the FC Barcelona partnership. This authentication system is battle-tested in production at app.andamio.io handling real users and transactions daily. We've refined it through months of production use, making it ready to serve as foundational infrastructure for the broader ecosystem.

Validation through:

• Community feedback during development

• Security audit before final release

• Beta testing with selected Cardano projects

[Milestones] Project Milestones

Milestone Title

Core Template

Milestone Outputs

• T3 App template with Cardano wallet connection (CIP-30)

• Prisma database with basic user schema

• Protected tRPC routes for authenticated database access

• Protected page routes for authenticated user based on wallet connection

• Simple JWT session management

• TypeScript throughout

• Video walkthrough

Acceptance Criteria

• Andamio Auth template is available for anyone to use
• Template provides Cardano wallet connection, database configuration, protected routes, and JWT session management
• Initial documentation is generated from Typescript codebase

Evidence of Completion

• Public, open-sourced (MIT) repository on GitHub with the Core Template
• Video walkthrough, published on YouTube
• Link to initial public draft of documentation, which will be completed in Milestone 3

Delivery Month

1

Cost

16000

Progress

20 %

Milestone Title

OAuth2 Compliance & Standards

Milestone Outputs

• OAuth2-compliant token structure with JWT access tokens and refresh tokens

• OAuth2 Authorization Code flow implementation using Cardano wallet signatures

• Scope-based permissions mapped to Andamio credentials

• JWT expiration and refresh token rotation

• OAuth2-compatible API endpoints following RFC standards

• Security compliance

Acceptance Criteria

• A report on OAuth2 compliance
• Updated documentation includes advanced JWT management
• The Core Template from Milestone 1 is extended so that it can be configured for specific Cardano Native Assets and for specific Andamio credentials

Evidence of Completion

• Link to OAuth2 compliance report
• Link to updated Andamio Auth template
• Link to updated documentation

Delivery Month

3

Cost

16000

Progress

50 %

Milestone Title

Documentation & Quick Start Guide

Milestone Outputs

• Industry-standard README.md and "Getting Started" guide that help devs get the template up and running with Web3 Auth in under 10 minutes.

Advanced Guides, including:

• Configuration docs for different Cardano networks

• Token dependency configuration

• Database customization guide

• JWT customization guide

Acceptance Criteria

• A README.md file is published in the public GitHub repository
• A Getting Started guide is published at docs.andamio.io
• Advanced documentation, including network configuration, token dependency configuration, database customization, and JWT customization

Evidence of Completion

• Link to README.md file
• Link to "Getting Started with Andamio Auth" guide
• Link to advanced documentation

Delivery Month

4

Cost

12000

Progress

70 %

Milestone Title

Hands-on Starter Kit

Milestone Outputs

• Full-stack sample application using the Andamio Auth template

• Real-world use case implementation

• Best practices demonstration

• Deployment guide

• Tips and tricks

• Host first two live community session

Acceptance Criteria

• Documentation supports developers to start using the template
• Communications channels are open for devs in need of support, both via Discord and via live sessions
• Example application demonstrates the features of Andamio Auth template, so that developers can learn through a hands-on example how to use Andamio Auth

Evidence of Completion

• Link to deployed example application
• Links to Andamio Discord and live event calendar
• Link to starter kit that provides a step-by-step guide to building a new application

Delivery Month

5

Cost

12000

Progress

90 %

Milestone Title

Andamio SDK Integration

Milestone Outputs

• Integrate Andamio SDK (Fund 13 proposal) and provide documentation on how to use Andamio SDK to build additional features

• Token-gated content examples

• Credential-gated access control

• Smart contract interaction patterns

• Community showcase and feedback incorporation

• Host two more live community sessions

Acceptance Criteria

• Andamio Auth template includes examples of how to incorporate Andamio SDK for greater functionality
• Examples of design patterns for interacting with Andamio contracts, accessing premium content, and accessing premium features
• Developer feedback channels are available and initial feedback is incorporated into the template

Evidence of Completion

• Link to Andamio SDK integration docs
• Links to (4) recorded live sessions
• Link to GitHub issue log showing improvements made to the template

Delivery Month

5

Cost

11200

Progress

100 %

[Final Pitch] Budget & Costs

Please provide a cost breakdown of the proposed work and resources

Development: ₳48,000

• 240 hours × ₳200/hour

• Core feature implementation, testing, and optimization

Security Review: ₳8,000

• 40 hours × ₳200/hour

• Code review and security best practices

• Community security audit

Documentation: ₳6,400

• 32 hours × ₳200/hour

• Technical documentation and setup guides

• Video tutorials and example projects

Community Engagement: ₳4,800

• 24 hours × ₳200/hour

• Developer workshops and support

• Community feedback incorporation

Total: ₳67,200 (336 hours @ ₳200/hour)

[Final Pitch] Value for Money

How does the cost of the project represent value for the Cardano ecosystem?

This infrastructure will save each adopting project 2-3 months of development time (worth ~₳30,000+ per project). With just 2 projects using it, we've already returned the investment. With 10 projects in the first year, we create ₳300,000+ in value. As MIT-licensed open source infrastructure, it will continue providing value indefinitely, strengthening Cardano's competitive position against other blockchain ecosystems.

The standardization effect multiplies this value exponentially: reducing security vulnerabilities ecosystem-wide, enabling interoperability between dApps, and establishing Cardano as enterprise-ready. This aligns directly with the Cardano Foundation's strategic pillars of Technology (core tooling), Adoption (lowering barriers), and Governance (standardized identity). We're not proposing theoretical tooling - we're contributing production-proven infrastructure that's already securing user data at app.andamio.io to become a community-owned standard.

[Required Acknowledgements] Consent & Confirmation

Terms and Conditions:

Yes