NLFTs Developer Program

A modern, static website for the NLFTs Developer Program built with Nuxt 3

🚀 Features

• ✅ Static website with Nuxt Content
• ✅ Blog posts from markdown files
• ✅ Documentation pages
• ✅ Product showcase
• ✅ Events listing
• ✅ GitHub OAuth login (no database)
• ✅ Responsive design with Nuxt UI
• ✅ Dark mode support
• ✅ SEO optimized

📦 Tech Stack

• Framework: Nuxt 3
• UI Library: Nuxt UI
• Content: Nuxt Content
• Styling: Tailwind CSS
• Animations: GSAP
• Icons: Iconify
• Authentication: GitHub OAuth (localStorage)

🛠️ Setup

Prerequisites

• Node.js 20+
• pnpm (recommended)

Installation

1. Clone the repository:

git clone https://github.com/your-org/developer-program.git
cd developer-program

2. Install dependencies:

pnpm install

3. Setup environment variables:

cp .env.example .env

4. Configure GitHub OAuth:

   • Create a GitHub OAuth App at https://github.com/settings/developers
   • Update .env with your credentials
   • See SETUP_GITHUB_OAUTH.md for detailed instructions

5. Run development server:

pnpm dev

Visit http://localhost:3000

📝 Environment Variables

# GitHub Personal Access Token (for API calls)
GITHUB_TOKEN=your_github_personal_access_token

# Site URL
NUXT_PUBLIC_SITE_URL=https://nlfts.dev

# GitHub OAuth Configuration
GITHUB_CLIENT_ID=your_github_oauth_app_client_id
GITHUB_CLIENT_SECRET=your_github_oauth_app_client_secret
NUXT_PUBLIC_GITHUB_CLIENT_ID=your_github_oauth_app_client_id

🏗️ Build

# Build for production
pnpm build

# Preview production build
pnpm preview

📚 Documentation

• Refactor Summary - Overview of recent changes
• Refactor Notes - Detailed refactor documentation
• Setup GitHub OAuth - OAuth setup guide
• Checklist - Deployment checklist

🎨 Project Structure

.
├── app/
│   ├── assets/          # CSS and static assets
│   ├── components/      # Vue components
│   ├── composables/     # Vue composables
│   ├── layouts/         # Layout components
│   ├── pages/           # Page components (routes)
│   ├── plugins/         # Nuxt plugins
│   └── utils/           # Utility functions
├── content/             # Markdown content
│   ├── blog/            # Blog posts
│   ├── docs/            # Documentation
│   └── product/         # Product pages
├── public/              # Static files
├── server/              # Server API routes
│   └── api/
│       └── auth/        # Authentication endpoints
└── nuxt.config.ts       # Nuxt configuration

🔐 Authentication

This website uses a simple GitHub OAuth authentication system:

• User data is stored in localStorage (client-side only)
• No database backend
• No persistent storage
• Users must login again after clearing browser data

Login Flow

1. User clicks "Login" button
2. Redirected to GitHub OAuth
3. After authorization, redirected back to /confirm
4. User data fetched from GitHub API
5. Data stored in localStorage
6. User is logged in

🚀 Deployment

Vercel

vercel

Add environment variables in Vercel dashboard.

Netlify

netlify deploy

Add environment variables in Netlify dashboard.

Other Platforms

Build the project and deploy the .output directory.

📄 License

MIT License - see LICENSE for details

🤝 Contributing

Contributions are welcome! Please read our Code of Conduct first.

📞 Support

For support, email support@nlfts.dev or join our Discord community.

---

Made with ❤️ by the NLFTs Team