Stellar Tip Jar Frontend

A modern, open-source frontend starter for tipping creators with the Stellar network.

This repository uses Next.js (App Router), TypeScript, and TailwindCSS with a scalable folder structure designed for collaboration.

Project Description

Stellar Tip Jar allows supporters to send tips to creators using Stellar assets. This frontend starter includes:

• Landing page introducing the project
• Dynamic creator profile route (/creator/[username])
• Explore creators page (/explore)
• Tip flow placeholder (/tips)
• Reusable UI components (Button, Navbar)
• Wallet connection placeholder for future Stellar wallet integration
• API service layer prepared for backend communication

Setup Instructions

1. Clone the repository.
2. Install dependencies:

npm install

3. Create your local environment file:

cp .env.example .env.local

Development Instructions

1. Start development server:

npm run dev

2. Open http://localhost:3000.
3. Run lint checks:

npm run lint

4. Run type checking:

npm run typecheck

5. Build for production:

npm run build

Project Structure

src/
  app/          # App Router routes and layout
  components/   # Reusable UI components
  hooks/        # Reusable React hooks
  services/     # API service layer
  utils/        # Utility/helper functions
  styles/       # Global and shared styles

Notes for Contributors

• Keep route-specific UI inside src/app/<route>.
• Place reusable UI in src/components.
• Put API integration logic in src/services.
• Keep wallet implementation details in src/hooks/useWallet.ts.

Environment Variables

See .env.example:

• NEXT_PUBLIC_API_URL - backend base URL
• NEXT_PUBLIC_STELLAR_NETWORK - Stellar network (testnet by default)

License

This project is licensed under the MIT License.