forked from SAP/spartacus-docs
-
Notifications
You must be signed in to change notification settings - Fork 0
/
index.html
153 lines (86 loc) · 7.89 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
---
---
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>Home</title>
</head>
<body>
<img src="assets/images/spartacus-blue.png" alt="Spartacus JavaScript Storefront">
</br></br>
<h1 id="what-is-spartacus">What is Spartacus?</h1>
<p>If you are working with an older version of the Spartacus libraries, you can find the full suite of corresponding documentation in our <a href="https://sap.github.io/spartacus-docs-v1/">Documentation Archive.</a></p>
<p>Spartacus is a lean, Angular-based JavaScript storefront for SAP Commerce Cloud. Spartacus talks to SAP Commerce Cloud exclusively through the Commerce REST API.</p>
<p>See the following introductory videos for a quick overview of Spartacus:
<ul>
<li><a href="https://enable.cx.sap.com/media/Introduction+to+Spartacus+-+SAP+Commerce+Cloud/1_6dln57h9">Introduction to Spartacus</a></li>
<li><a href="https://enable.cx.sap.com/media/Spartacus+in+60+Seconds+-+SAP+Commerce+Cloud/1_hwaie89l">Spartacus in 60 seconds</a></li>
<li><a href="https://enable.cx.sap.com/tag/tagid/spartacus">All videos</a>
</ul>
</p>
<p>If you have technical questions, you can get in touch with us on <a href="https://stackoverflow.com/questions/tagged/spartacus-storefront">Stack Overflow</a>. For non-technical questions, you can reach us on our <a href="https://join.slack.com/t/spartacus-storefront/shared_invite/enQtNDM1OTI3OTMwNjU5LTg1NGVjZmFkZjQzODc1MzFhMjc3OTZmMzIzYzg0YjMwODJiY2YxYjA5MTE5NjVmN2E5NjMxNjEzMGNlMDRjMjU">Slack workspace</a>. Feedback welcome!
</p>
<h2 id="extensible">Extensible</h2>
<p>Spartacus is designed to be upgradable while maintaining full extendability. You'll be able to adopt new versions of Spartacus by updating the Spartacus libraries that we will regularly enhance.</p>
<p>Version 1.0.0 was released July 4, 2019, a month after SAP Commerce Cloud 1905. </p>
<h2 id="progressive">Progressive</h2>
<p>Spartacus is on a journey to be fully compliant with the Progressive Web Application (PWA) checklist. We aim to add support for all major features of a PWA-enabled storefront, to offer the best possible customer experience regardless of device or location.</p>
<h2 id="open-source">Open Source</h2>
<p>Spartacus is open source. It will be continually developed by the SAP Commerce Cloud team, but we are very keen to welcome contributors and to foster an inclusive, active development community for Spartacus.</p>
<p>See <a href="{{ site.baseurl }}{% link _pages/contributing/contributing-to-the-spartacus-storefront.md %}">Contributing to the Spartacus Storefront</a> for more information.</p>
<h2 id="technology">Technology</h2>
<p>The Spartacus storefront is part of our exciting new journey towards a customizable-yet-upgradable technology for SAP Commerce Cloud installations.</p>
<p>See <a href="https://www.sap.com/products/crm/e-commerce-platforms.html">SAP Customer Experience</a> for more information about SAP Commerce Cloud.</p>
<h2 id="storefront-features">Storefront features</h2>
<p>Spartacus provides core storefront features such as:</p>
<ul>
<li>home page</li>
<li>search</li>
<li>categories</li>
<li>product details</li>
<li>cart page</li>
<li>adding to cart</li>
<li>checkout</li>
<li>order history</li>
</ul>
<h1 id="requirements">Requirements</h1>
{% include docs/frontend_requirements.html %}
<p>For the back end, SAP Commerce Cloud version 1905 or higher is required.</p>
<h1 id="download-and-installation">Download and Installation</h1>
<p>To get up and running with Spartacus, the recommended approach is to build your storefront application from ready-made libraries. You can also clone and build from source, but upgrading is not as simple.</p>
<p>Spartacus currently can only be used with a SAP Commerce Cloud instance through Commerce APIs.</p>
<p>For complete setup instructions, see the <a href="{{ site.baseurl }}{% link _pages/install/building-the-spartacus-storefront-from-libraries.md %}">Building the Spartacus Storefront from Libraries</a> guide.</p>
<h2 id="customizing-and-extending-spartacus">Customizing and Extending Spartacus</h2>
<p>To maintain our promise of upgradability, the design pattern for Spartacus is for non-core features to be built as feature libraries that add to or change the provided functionality.</p>
<p>When using Spartacus, you build an app that pulls in the Spartacus libraries, which contain the core resources needed to work with SAP Commerce. You then build new features that contain any custom functionality and pages.</p>
<p>Content for Spartacus pages is fetched from the SAP Commerce Cloud CMS (Content Management System), such as logos, links, banners and static pages. We recommend that new content-driven features follow the same pattern to enable Content Managers to modify page content through the CMS tools.</p>
<p>The documentation for customizing and extending Spartacus is still under development and is being released as it becomes available.</p>
<h1 id="limitations">Limitations</h1>
<p>With the release of 1.0.0, it is recommended to use SAP Commerce 1905. Spartacus works with Release 1808 and 1811 of SAP Commerce Cloud, with some limitations.
<p>Spartacus is also being updated so that it works well with upcoming releases of SAP Commerce Cloud. This means that certain features of Spartacus may only work with unreleased future editions of SAP Commerce Cloud. This will be noted as we release new versions of Spartacus.</p>
<h1 id="known-issues">Known Issues</h1>
<p>Known issues are documented in the GitHub issue tracking system.</p>
<h1 id="how-to-obtain-support">How to Obtain Support</h1>
<p>Spartacus is provided "as-is" with no official lines of support.</p>
<p>To get help from the Spartacus community:</p>
<ul>
<li>For more general questions, post a question in the Help chat of our <a href="https://join.slack.com/t/spartacus-storefront/shared_invite/enQtNDM1OTI3OTMwNjU5LTg1NGVjZmFkZjQzODc1MzFhMjc3OTZmMzIzYzg0YjMwODJiY2YxYjA5MTE5NjVmN2E5NjMxNjEzMGNlMDRjMjU">Slack workspace</a>.</li>
<li>For developer questions, post a question to <a href="https://stackoverflow.com/questions/tagged/spartacus-storefront">Stack Overflow with the 'spartacus-storefront' tag</a>.</li>
</ul>
<h1 id="contributing">Contributing</h1>
<p>Team Spartacus welcomes feedback, ideas, requests, and especially code contributions.</p>
<ul>
<li>Post comments to our feedback channel in our <a href="https://join.slack.com/t/spartacus-storefront/shared_invite/enQtNDM1OTI3OTMwNjU5LTg1NGVjZmFkZjQzODc1MzFhMjc3OTZmMzIzYzg0YjMwODJiY2YxYjA5MTE5NjVmN2E5NjMxNjEzMGNlMDRjMjU">Slack</a> workspace.</li>
<li>Read <a href="{{ site.baseurl }}{% link _pages/contributing/contributing-to-the-spartacus-storefront.md %}">Contributing to the Spartacus Storefront</a> to learn how to:</li>
<li>Help others</li>
<li>Report an issue</li>
<li>Contribute code to Spartacus</li>
</ul>
<h1 id="publicInstance">Public instance of Spartacus</h1>
<p>To view our public instance, see <a href="https://spartacus.c39j2-walkersde1-d4-public.model-t.cc.commerce.ondemand.com/electronics-spa/en/USD/">Spartacus</a></p>
<p>We are running this on our SAP Commerce Cloud (CCv2). We may have our latest version on the link above, however, we hope in the future to always update our deployments frequently.</p>
<h1 id="to-do">To Do</h1>
<p>Many improvements are coming! All tasks will be posted to our GitHub issue tracking system. As mentioned, some of the improvements will mean breaking changes. While we strive to avoid doing so, we cannot guarantee this will not happen before the first release.</p>
<h1 id="license">License</h1>
<p>Copyright (c) 2019 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under the Apache Software License, v. 2 except as noted otherwise in the <a href="https://github.com/SAP/spartacus/blob/develop/LICENSE">LICENSE</a> file.</p>