Skip to content

Commit 6e3ebbb

Browse files
authored
Update README.md
1 parent dd285a1 commit 6e3ebbb

File tree

1 file changed

+80
-2
lines changed

1 file changed

+80
-2
lines changed

README.md

Lines changed: 80 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,80 @@
1-
# CodeShareHubLaravelGraphQL
2-
A collaborative code snippet manager powered by GraphQL, built on Laravel 10 and PHP 8.2. Share, discuss, and collaborate on code effortlessly.
1+
# Code Snippet Manager
2+
3+
Code Snippet Manager is a tool designed to simplify the process of managing and sharing code snippets among developers. It leverages Laravel 10, PHP 8.2, and Redis for caching to provide an efficient and user-friendly platform for developers to store, retrieve, and collaborate on code snippets seamlessly.
4+
5+
## Features
6+
7+
- **GraphQL API:** The core of this tool is built around a GraphQL API, allowing developers to interact with the system using a flexible and powerful query language.
8+
- **Snippet Management:** Easily create, update, delete, and retrieve code snippets. Each snippet is associated with metadata such as title, description, tags, and language for efficient organization.
9+
- **Search and Filtering:** Quickly find the snippets you need using search queries and filtering options based on tags, language, and more.
10+
- **User Authentication: Secure user authentication and authorization are integrated, ensuring that only authorized users can access and modify their own snippets.
11+
- **Sharing and Collaboration:** Share snippets with other developers by generating unique links, allowing for easy collaboration and discussion.
12+
- **Caching with Redis:** Utilize Redis for caching to optimize the performance of the application, ensuring fast response times even during peak usage.
13+
14+
## Installation
15+
16+
Follow these steps to set up and run the Code Snippet Manager on your local environment:
17+
18+
Clone the repository:
19+
20+
```bash
21+
git clone https://github.com/basemax/CodeShareHubLaravelGraphQL.git
22+
cd CodeShareHubLaravelGraphQL
23+
```
24+
25+
Install dependencies using Composer:
26+
27+
```bash
28+
composer install
29+
```
30+
31+
Copy the `.env.example` file to `.env`:
32+
33+
```bash
34+
cp .env.example .env
35+
```
36+
37+
Configure your database settings in the `.env` file.
38+
39+
Set up Redis for caching by providing the necessary Redis connection details in the .env file.
40+
41+
Generate the application key:
42+
43+
```bash
44+
php artisan key:generate
45+
```
46+
47+
Run database migrations:
48+
49+
```bash
50+
php artisan migrate
51+
```
52+
53+
Start the development server:
54+
55+
```bash
56+
php artisan serve
57+
```
58+
59+
Access the application via your browser at `http://localhost:8000`.
60+
61+
## Usage
62+
63+
- Register for an account or log in if you already have one.
64+
- Once logged in, you can create, view, edit, and delete your code snippets.
65+
- Utilize the GraphQL API at /graphql to interact with the system programmatically. Refer to the API documentation for available queries and mutations.
66+
- To share a snippet, generate a shareable link and share it with other developers. They can access and discuss the snippet through the provided link.
67+
68+
## Contributing
69+
70+
- Contributions to the Code Snippet Manager project are welcome! To contribute:
71+
- Fork the repository.
72+
- Create a new branch for your feature or bug fix.
73+
- Implement your changes and ensure all tests pass.
74+
- Submit a pull request to the main repository, describing your changes and their purpose.
75+
76+
## License
77+
78+
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.
79+
80+
Copyright 2023, Max Base

0 commit comments

Comments
 (0)