You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The goal of **User Story** is to design and present a scalable backend infrastructure that delivers a web interface allowing users to request new features and give feedback in an easy and intuitive way. Users can attach files with their story to explain what they want. The admins can then resolve, close and update the status of these stories. Users can interact with other stories via comments and votes. This can also serve as an efficient feedback and response mechanism which is critical for any organization to improve and make progress. Simply, its a **product management tool**.
8
9
9
-
In the project directory, you can run:
10
+
# How it works
10
11
11
-
### Starting up the project
12
+

13
+
14
+
# Guidelines for development
15
+
### Setting up the project
12
16
13
17
After cloning this repository you will need to install all the dependencies: `npm i`
14
18
15
-
There are two options to set up the `backend` for this repository:
19
+
User Story uses [this repository](https://github.com/EOS-uiux-Solutions/strapi) as its `backend`. There are two ways to set up the `backend`:
16
20
17
-
1. If you are planning to work only on the UI/UX of `eos-user-story`, then follow along. Skip to point 2 if you need to setup backend as well. For setting up using `docker`, first make sure you have `docker` & `docker-compose` installed ([Install instructions](https://docs.docker.com/engine/install/)). Next, run `docker-compose up` and wait for the server to start on `http://localhost:1337`. Visit [http://localhost:1337/admin/auth/](http://localhost:1337/admin/auth/) and create the admin user for Strapi. Then set the roles and permissions for the api endpoints. That's it, the backend is up and running. Proceed to the next paragraph for further instructions.
21
+
- You can use Docker to setup backend by following [these instructions](https://github.com/EOS-uiux-Solutions/strapi#using-docker) If you are planning to work only on the `frontend` of User Story, then follow along.
18
22
19
-
2. This repository uses [EOS-uiux-Solutions/strapi](https://github.com/EOS-uiux-Solutions/strapi) as the backend Strapi server. Follow[these](https://github.com/EOS-uiux-Solutions/strapi#how-to-install-it) instructions to set it up.
23
+
- You can setup `backend` locally by following[these instructions](https://github.com/EOS-uiux-Solutions/strapi#locally).
20
24
21
-
After setting up the backend, you need to connect the frontend to the Strapi server. To do this, duplicate the file `src/config.json.template` into a new file called `src/config.json` and replace the content of the variable with your server URL.
25
+
If you want to work only on the `frontend` then go to `src/config.json` and change the value of `apiURL` to `https://userstory-strapi.herokuapp.com`.
22
26
23
-
Then run: `npm start` to run the app in the development mode.
27
+
Then run: `npm start` to run the app in development mode.
24
28
25
29
Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
26
30
27
-
The page will reload if you make edits.<br />
28
-
You will also see any lint errors in the console.
31
+
The page will reload if you make edits. You will also see any lint errors in the console.
29
32
30
33
### JS and SCSS quality assurance
31
34
@@ -38,10 +41,10 @@ To make sure your SCSS is compliant run: `npm run test:scss`
38
41
39
42
`npm run build`
40
43
41
-
Builds the app for production to the `build` folder.<br />
42
-
It correctly bundles React in production mode and optimizes the build for the best performance.
44
+
Builds the app for production to the `build` folder. It correctly bundles React in production mode and optimizes the build for the best performance.
43
45
44
46
The build is minified and the filenames include the hashes.<br />
47
+
45
48
Your app is ready to be deployed!
46
49
47
50
See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.
@@ -50,7 +53,7 @@ See the section about [deployment](https://facebook.github.io/create-react-app/d
50
53
51
54
### Code contributions
52
55
53
-
1. Open a new or pick an open issue from the issue list and claim it in the comments. Make sure that the issue is confirmed so you don't work on something that will not be approved to be merged.
56
+
1. Open a new issue or pick an open issue from the issue list and claim it in the comments. Make sure that the issue is confirmed so you don't work on something that will not be approved to be merged.
54
57
2. Make sure you follow our best practices: [refer to our Wiki](https://gitlab.com/SUSE-UIUX/eos/-/wikis/home). You'll find information on writing code, how to name a branch, how we release, etc.
55
58
3. Join Slack [optional] to get in touch with the maintainers if you have any doubt: [join slack](http://slack.eosdesignsystem.com/)
56
59
4. Make sure you fork the project, cloning it will not give you the right access to open a PR/MR. [How to open a PR in open source](https://gitlab.com/SUSE-UIUX/eos/-/wikis/Basic-git-instructions-for-beginners)
@@ -59,7 +62,7 @@ See the section about [deployment](https://facebook.github.io/create-react-app/d
59
62
60
63
If you'd like to contribute with design changes, you'll have to do as follows:
61
64
62
-
1.[Open an issue](https://gitlab.com/SUSE-UIUX/eos-feature-request/-/issues/new)
65
+
1.[Open an issue](https://github.com/EOS-uiux-Solutions/user-story/issues/new)
63
66
2. Add all relevant information to the issue. Please be as descriptive as possible. Add links to references, images, videos, etc.
64
67
3. While working on your design, please make sure you follow our [design guidelines](https://gitlab.com/SUSE-UIUX/eos/wikis/Design-process-and-feedback-gathering).
65
68
4. Once the issue is approved by us, it'll be ready to be implemented.
0 commit comments