Welcome to the KOMMA website documentation! This guide will help you make changes to the website, even if you don't have any programming experience.
The KOMMA website is:
- Hosted on Vercel under Charlie's account
- Built with Next.js and Tailwind CSS
- Currently being enhanced with a dynamic Projects page that will pull content from Notion
If you're just looking to make simple text changes, you can skip to the "Making Content Changes" section below.
If you need to set up the website on your computer to preview changes:
- Download and install Cursor (our preferred code editor) or Visual Studio Code
- Download and install Node.js (choose the "LTS" version)
- Open Cursor/VS Code
- Open the website folder in the editor
- Open the terminal (View → Terminal)
- Type these commands in the terminal:
npm install npm run dev - Open your web browser and go to http://localhost:3000
The Projects page will be dynamically updated using content from Notion. This means:
- Project information will be managed in Notion
- Changes in Notion will automatically update the website
- No need to edit code for project updates
- Log into the KOMMA Notion workspace
- Navigate to the Projects database
- Add or edit project information:
- Project title
- Description
- Images
- Links
- Status
- Changes will automatically sync to the website
Note: The Projects page integration is currently in development. Once complete, this will be the primary way to update project information.
The website content is organized into different files, each representing a page:
app/page.tsx- The home page (what visitors see first)app/about/page.tsx- The About pageapp/contact/page.tsx- The Contact pageapp/projects/page.tsx- The Projects page (coming soon)
To edit a page:
- Open Cursor/VS Code
- In the left sidebar, find the
appfolder - Click on the folder for the page you want to edit (e.g.,
aboutfor the About page) - Click on
page.tsxinside that folder
When you open a file, you'll see something that looks like this:
<p className="text-black/80 mb-6">
This is the text you can change.
</p>To change the text:
- Find the text you want to change (it will be between the
<p>and</p>tags) - Edit the text while keeping the
<p className="...">and</p>parts unchanged - Save the file (Ctrl+S or Cmd+S)
If you need to add a completely new page (like a Projects page), please contact the development team at hello@komma.systems. They can help you set up the page with the correct structure and styling.
The website uses a consistent style across all pages:
- Background color: Black
- Text color: White
- Accent color: Cream (for special sections)
If you need to change any colors or styling, please contact the development team to ensure consistency across the website.
To add or change images:
- Place your image file in the
publicfolder - Contact the development team to help you add it to the website
The website logo is stored as public/Logo.png. If you need to update the logo, simply replace this file with your new logo (keeping the same filename).
After making changes:
- Save all your changes
- Contact the development team at hello@komma.systems
- They will review your changes and make them live on the website
Note: The website is hosted on Vercel under Charlie's account. The development team has access to deploy changes.
If you're unsure about making any changes or run into issues:
- Take a screenshot of what you're trying to change
- Email the development team at hello@komma.systems
- They'll help you make the changes or make them for you
- Open
app/about/page.tsx - Find the text you want to change
- Edit the text between the
<p>tags - Save the file
- Open
app/contact/page.tsx - Find the email address or other contact details
- Update the information
- Save the file
- Open
app/about/page.tsx - Find the team member section
- Copy an existing team member's section
- Update the name, description, and LinkedIn link
- Save the file
- Log into Notion
- Navigate to the Projects database
- Add or edit project information
- Changes will automatically sync to the website
Remember: If you're ever unsure about making changes, it's always better to ask for help than to make changes you're not confident about.
The site is deployed using Vercel. Changes pushed to the main branch will trigger an automatic deployment.
- Create a new branch for your changes
- Make your changes
- Submit a pull request
- Request review from team members
For questions or issues, contact the development team at hello@komma.systems