Skip to content

TheBluCoder/Verses

Repository files navigation

Verses - Collaborative Poetry Platform

"Verses" | where words take flight

Building a community-driven platform for collaborative poetry and creative expression

About Verses

Verses is an innovative social poetry platform that enables free creative collaboration and expression. Our mission is to provide an inclusive space for poets and writers to share their work, connect with others, and discover new voices without barriers. The platform features a clean, intuitive interface designed to put the focus on the art of poetry.

Current Functionality Showcase

Here's a glimpse of the current features and user interface:

Creating a New Poem:

Users can start a new poem with a simple, clean editor interface.

User Profile:

User Profile

Each user has a profile page showcasing their pen name, bio, and published poems.

Browse Recent Poems:

Recent Poems Feed

The homepage displays a feed of recent poems from the community.

Sign In:

Sign In Page

Users can securely sign in to their accounts.

Join Verses (Registration):

Join Verses Page

New users can join the platform by providing a pen name, email, and password.

Viewing a Specific Poem:

Viewing a Poem

Users can view individual poems, like "CROSSROAD," within a clean reading experience as well as see the comment section.

Key Features

  • Personalized User Profiles
  • Content Discovery (Recent and Top Poems)
  • Poem Creation and Editing
  • Social Interaction (Likes, comments)
  • Secure User Authentication
  • Free and Accessible

Tech Stack

  • Backend: Laravel
  • Database: PostgreSQL
  • Frontend: Vue.js
  • Rich Text Editor: Tiptap Editor
  • UI/UX: Clean, minimalist design with a focus on readability.
  • Hosting: Laravel Cloud

Getting Started

Prerequisites

  • PHP 8.1 or higher
  • Composer
  • Node.js and NPM
  • PostgreSQL
  • Laravel CLI

Installation

  1. Clone the repository
git clone [https://github.com/yourusername/verses.git](https://github.com/yourusername/verses.git)
cd verses
  1. Install PHP dependencies
composer install
  1. Install JavaScript dependencies
npm install
  1. Set up environment variables
cp .env.example .env
  1. Configure your database settings in .env and ensure the database is running.

  2. Run migrations to set up your database schema.

php artisan migrate
  1. Start the development server.
php artisan serve

Contributing

We welcome contributions from the community! Whether you're a developer, designer, or poetry enthusiast, there are many ways to get involved:

  • Report bugs
  • Suggest new features
  • Submit pull requests
  • Improve documentation
  • Help with testing

How to Contribute

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Contact

If you're interested in collaborating or have any questions, please reach out:

License

This project is open-sourced software licensed under the MIT license.

Acknowledgments

  • Thanks to all contributors and the open-source community
  • Special thanks to the Laravel, Vue.js, and Tiptap teams for their amazing tools
  • Inspired by the need for accessible creative spaces in the digital age

About

Collaborative Poetry Platform

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published