Plektos is a decentralized meetup platform built on Nostr. It enables users to create, join, and manage event. As a decentralized application, Plektos gives users full control over their data and event management without relying on centralized services.
- 🎯 Create and manage events with detailed information
- 📅 Schedule and organize meetups
- 📍 Location-based event discovery
- ⚡ Use Zaps to pay for event tickets
- 🔔 Real-time notifications for RSVPs, comments, and zaps
- 🛡️ Decentralized data storage through Nostr
- 🔒 User-controlled data and privacy settings
- 🎭 Optional anonymous participation
- 🚀 Built with React 18 and Vite for optimal performance
- 🎨 Modern UI components using shadcn/ui and TailwindCSS
- 📱 Responsive design for all devices
- 🌙 Dark mode support
- 🔄 Real-time updates
- 🔍 Advanced search capabilities
- Frontend Framework: React 18.x
- Styling: TailwindCSS 3.x
- Build Tool: Vite
- UI Components: shadcn/ui
- Nostr Integration: Nostrify
- State Management: TanStack Query
- Routing: React Router
- Type Safety: TypeScript
- Node.js 18.x or later
- npm or yarn package manager
-
Clone the repository:
git clone https://github.com/derekross/plektos.git cd plektos
-
Install dependencies:
npm install # or yarn install
-
Start the development server:
npm run dev # or yarn dev
-
Open your browser and navigate to
http://localhost:5173
npm run dev
- Start development servernpm run build
- Build for productionnpm run preview
- Preview production buildnpm run test
- Run testsnpm run lint
- Run linternpm run format
- Format code with Prettier
plektos/
├── src/
│ ├── components/ # UI components
│ ├── hooks/ # Custom React hooks
│ ├── pages/ # Page components
│ ├── lib/ # Utility functions
│ └── main.tsx # Application entry point
├── public/ # Static assets
└── package.json # Project dependencies
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add some amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.