nounspace

Highly customizable Farcaster client, initially funded by a grant from Nouns DAO. Customize the look, sound, content, and functionality of your public profile space and personal feed/homebase with Themes, Tabs, and a growing library of mini-apps called Fidgets.

Forked from herocast in April 2024.

Docs

https://docs.nounspace.com/nounspace-alpha/

What is Farcaster?

a protocol for decentralized social apps: https://www.farcaster.xyz

🏗️ Dev Setup

1. Clone the repo

   git clone https://github.com/Nounspace/nounspace.ts.git
   cd nounspace.ts

2. Install Supabase CLI On Mac OS, for example:

   brew install supabase/tap/supabase

3. Install dependencies

   yarn install

4. Create a file .env.development.local
5. Get the environment variables you need for the file
   a. get a Neynar API key https://docs.neynar.com/docs -> NEYNAR_API_KEY
   b. get an Alchemy API key https://www.alchemy.com -> NEXT_PUBLIC_ALCHEMY_API_KEY
   c. get an Etherscan API key https://docs.etherscan.io/getting-started/ -> 'ETHERSCAN_API_KEY'
   d. get a CoinGecko API key https://www.coingecko.com/en/api -> 'COINGECKO_API_KEY'
   e. get a Clanker API key https://github.com/clanker-devco/DOCS -> 'CLANKER_API_KEY' (dev portal coming soon; request a key from the nounspace or Clanker team for now)
   f. get a Youtube API key https://developers.google.com/youtube/v3 -> 'YOUTUBE_API_KEY'
   g. get your Farcaster account FID and mnemonic -> NEXT_PUBLIC_APP_FID + APP_MNENOMIC
   h. launch local copy of Supabase with supabase start (in the root directory of this repo), use the info provided ->
   API URL:NEXT_PUBLIC_SUPABASE_URL + anon key:NEXT_PUBLIC_SUPABASE_ANON_KEY

Contributing and making Fidgets

See the contributing docs for how to add to the code base. Register on Scout Game to earn points for contributions to repos in the nounspace org.

Code Design

The Nounspace App follows the Atomic Design Pattern

src/pages holds the Page elements of the atomic design. These are separated from src/common due to how Next.js handles routing.

src/common/ui contains all of the display components for all other layers of the atomic design. src/common/ui/components are a mixture of Molecules and Organisms that were imported from herocast, they still need to be split into their appropriate folders (src/common/ui/molecules & src/common/ui/organisms).

src/common/data contains access to datastreams, in the form of database connections and API's

src/common/lib contains useful functions for accessing formatted data, along with helpers functions inside the utils directory.

src/styles contains information for managing website styling

src/constants contains all static information that is needed to run the app. This includes actual constants, along with some global types

Refactoring

This file structure is adapted from herocast, and not all files have been cleaned up properly. If you find files or data that are placed in the wrong location, please refactor them to correct file or folder. For example, there are some constants that are not placed in the src/constants directory, and instead are in the other files.

DB scheme: accounts

reminder: key is an edcsa key not a 'normal' EVM address

License

nounspace is released under the GPL-3.0 License. Feel free to fork and modify the project—just be sure any version you release uses the GPL-3.0 License too.

Made with ❤️ by the Nounspace team & community. Questions or feedback? Create a Github issue or contact us in Discord