Skip to content

This is a user-friendly template that is suitable for both novice and experienced developers.

License

Notifications You must be signed in to change notification settings

nekofar/farcaster-frames-template

Repository files navigation

Farcaster Frames Template

GitHub release (latest SemVer including pre-releases) GitHub X (formerly Twitter) Follow Farcaster (Warpcast) Follow Donate

Farcaster Frames Template is an easy-to-use template designed for beginners and experienced developers alike. It provides a robust starting point for building Farcaster Frames, streamlining the development process. This template is ideal for those looking to create custom frames quickly and efficiently.

Getting Started

Prerequisites

  • Node.js (Version 18 or later)
  • A text editor like VSCode
  • Basic understanding of TypeScript and Node.js

Use Template

You can use this repository as a template to create a new GitHub repository with the same directory structure and files. Here's how:

  1. On the repository page, click the Use this template button.
  2. Choose the owner of the new repository and enter a repository name.
  3. Optionally, add a description for your repository.
  4. Choose the repository visibility (Public or Private).
  5. Click Create repository to create your new repository from template.

After creating your repository from this template, clone it and install the dependencies.

Installation

  1. Clone the repository:
    git clone https://github.com/yourname/farcaster-frames-template.git
  2. Navigate to the project directory:
    cd farcaster-frames-template
  3. Install the dependencies:
    pnpm install
  4. Start the development server:
    pnpm run dev

Usage Guide

The template uses Localtunnel which allows you to easily test your frames without the need to deploy them. Everytime running your project, you will receive a random URL, for example https://thirty-glasses-tell.loca.lt. You can directly copy this URL and test your frame using the Warpcast Embed Tools. This makes the development and testing process much more efficient and straightforward.

For detailed information on working with Farcaster Frames, refer to the Farcaster Frames documentation. Additionally, to learn more about Hono, visit the Hono documentation.

Contributing

Contributions are what make the open source community such a fantastic place to learn, inspire, and create. Any contributions you make are greatly appreciated