Access the Admin Panel
With both servers running (from the previous guide), open your browser and go to:
http://localhost:8080/admin/
Local Backend Mode
Because your config.yml has local_backend: true, Decap CMS skips the login screen entirely when running on localhost. You are automatically authenticated and can start editing immediately.
If you see a login screen asking for GitHub credentials, check that:
1. local_backend: true is present at the top level of public/admin/config.yml
2. You ran npx decap-server in the correct folder
3. You accessed the site through localhost or 127.0.0.1, not a custom hostname
Understanding the Interface
The admin panel has three main areas:
Left sidebar — Your collections. Click any collection name to see its entries. The Settings collection contains single-file pages (metadata, index, about, contact, etc.). The other collections (Blog Posts, Projects, Services, Docs Pages) contain multiple entries.
Center panel — The list of entries in the selected collection. Click an entry title to edit it.
Right panel — The editor. When you click an entry, this panel shows all its fields: title, description, body content, and any custom fields like image paths or code blocks.
Editing a Page
Click any entry to open the editor. You will see fields appropriate to that page. For example, editing a blog post shows:
- Title (text field)
- Description (text field)
- Topic (text field)
- Read Time (text field)
- Date (text field)
- Author (text field)
- Image (text field for the path)
- Body (markdown editor with formatting toolbar)
Make your changes and click Publish in the top right corner. The changes are written to the markdown file immediately.
Publishing Workflow
Decap CMS has two publishing modes: Simple and Editorial Workflow. Luax Pro uses Simple mode, which means clicking Publish saves changes directly to your files. There is no draft or review step.
If you want a draft workflow where changes are reviewed before going live, change publish_mode in config.yml to editorial_workflow. Note that this requires the proxy server to run in git mode.
If You Make a Mistake
If you accidentally change something and want to revert it, Decap CMS does not have an undo button. However, because your content is stored as plain markdown files, you can:
1. Open the file directly in a text editor
2. Revert the change manually
3. Or, if you use Git, run git checkout -- src/path/to/file.md
This is why using Git with your Luax Pro project is recommended even though it is not required.
Next Step
You are logged in and understand the interface. The next guide covers updating your site metadata through Decap CMS.