Read the guide in Getting Started to understand the basic concepts and the deco admin tool.
Important, you can access https://deco.cx/discord to ask questions or report issues with deco.cx. Join our community too!
- Technology stack
- Start developing
- Developing with deco
When creating a website or online store with deco.cx, users have the flexibility to create Sections and Loaders that meet their unique needs. To help you easily and quickly create these components, we rely on a set of powerful and efficient technologies.
Preact is a fast and lightweight alternative to React.js, used for rendering UI components on the server and client. It uses JSX to create web components and is generally straightforward to learn.
Tailwind is a CSS styling solution based on utility classes, making it ideal for beginners. Tailwind is also optimized for performance.
The only setup required to code deco.cx sites is to install Deno on your machine. To install Deno, follow the instructions on the deno.land page.
Make sure to keep Deno up-to-date! If you already have Deno installed, run
deno upgradeto update it.
Test Deco Locally (Optional)!
Deco offers a mechanism to test and explore our system without the need to deploy code or make a deployment on our infrastructure. To do this, visit: https://play.deco.cx/
Create a deco site
Important: Before proceeding with this section, make sure to check out Creating a Site.
deco.cx abstracts all the complexities of setting up a repository, connecting a CMS, and deploying to the edge. This allows you to focus only on what matters: the code and content of your site.
Clone your site repository
Accept the invitation to join the repository created for your site. This invitation is sent to the email address associated with your Github profile.
If you haven't used a GitHub account to log into the admin or haven't received an invitation, you can add a GitHub account as a collaborator to the site.
git clone command to download the site code to your machine. We
recommend using SSH. Open the terminal and execute the command:
git clone firstname.lastname@example.org:deco-sites/site-name.git
Remember to change
site-name to the name of your site.
Alternatively, you can clone the repository using other methods, such as git https, through the Github tool, or using an IDE. The repository page on Github provides details about different ways to clone.
Developing with deco
Run local server
In the terminal, simply navigate to the site folder and execute the command:
deno task start
Wait for the project to initialize. On the first run, deno will download and cache the project dependencies, and deco will prepare site details.
The site will be accessible at http://localhost:8000.
Some browsers may block access to or execution of code on the
localhostdomain! Disable browser ad blockers or privacy protections to access this address.
If the code of any section used on the site's homepage is modified, it will be reflected at the above address.
The development deployment process is very simple: do a git push of the changes to the main branch.
These changes will be available when accessing the dev URL (such as https://deco-sites-example.deno.dev/).
You can also create a deco.site domain that will make https://example.deco.site/ available to use. To do so, you need to request that to someone from the deco team.
Now you can start creating sites in your own way! :)
Keep exploring deco to understand its potential and how to create or modify sections, loaders, and other elements of deco to create increasingly personalized sites and experiences.
Be sure to join our Discord community. Stay updated with the latest news and keep evolving with us!