Repostea Client

Frontend application for Repostea - an open-source content aggregation platform.

Overview

This is the Nuxt 3 frontend for Repostea. For the complete platform setup, see the main repository.

Tech Stack

• Nuxt 3 - Vue framework with SSR
• Vue 3 - Composition API
• Pinia - State management
• Tailwind CSS - Styling
• TypeScript - Type safety
• i18n - 15+ languages

Quick Start

Note: You need the backend server running first.

# Install dependencies (use pnpm)
pnpm install

# Configure environment
cp .env.example .env

# Start development server
pnpm dev

Visit http://localhost:3000

Scripts

pnpm dev          # Development server
pnpm build        # Production build
pnpm preview      # Preview production build
pnpm quality      # Run ESLint + Prettier
pnpm test         # Run Vitest unit tests
pnpm test:e2e     # Run Cypress E2E tests

Configuration

Edit .env file:

# API endpoint (your backend server)
NUXT_PUBLIC_API_BASE=http://localhost:8000/api
NUXT_PUBLIC_SERVER_URL=http://localhost:8000
NUXT_PUBLIC_SITE_URL=http://localhost:3000

# Site branding
NUXT_PUBLIC_APP_NAME=Repostea

See .env.example for all available options.

Project Structure

client/
├── components/     # Vue components
├── composables/    # Reusable logic (use*)
├── i18n/           # Translations
├── pages/          # Nuxt pages (file-based routing)
├── stores/         # Pinia stores
├── public/         # Static assets
└── server/         # Server middleware

Full Documentation

For complete setup instructions including:

• Backend installation
• Database configuration
• Production deployment
• Nginx/Apache setup

See the Server Repository.

Contributing

1. Fork the repository
2. Create a feature branch
3. Run pnpm quality before committing
4. Open a Pull Request

Using Repostea?

We'd love to hear from you! Let us know if you're running a Repostea instance.

License

GPL-3.0